ログを使用したトラブルシューティング

デプロイメント・バックアップで見つかったOCIロギングおよびログを使用して一般的な問題をトラブルシューティングし、OCI GoldenGateデプロイメントから診断を収集する方法について学習します。

関連項目

Oracle Cloudコンソールを使用したトラブルシューティング

プロセスおよびエラー・ログ

OCIロギングをOCI GoldenGateと統合して、GoldenGateプロセスおよびエラー・ログを有効化、管理および検索できます。ロギング・サービスとの統合はオプションです。

エラー・ログ: GoldenGateによって生成された処理イベント、メッセージ、エラーおよび警告を記録するggserr.logファイルのコンテンツが含まれます。
プロセス・ログ: 管理サービス、分散サービス、パフォーマンス・メトリック・サービス、レシーバ・サービスおよびExtract/Replicatイベントの複数のログ・ファイルのコンテンツが含まれます。

OCIロギングの使用を開始する前に:

OCIロギング・サービスで使用される基本的な概念および用語について理解します。OCIロギング・ドキュメントのロギングの概要を参照してください。
ログ・グループおよびログ・コンテンツへのアクセスを管理するグループを作成します。OCI IAMドキュメントのグループの使用を参照してください。
OCI GoldenGateのパブリック・ロギングを有効にするポリシーを追加します。

ノート:

OCI GoldenGateによって自動的に作成されるログを含むログ・ライフサイクルを管理します。ジョブおよびジョブ実行が削除されてもログは削除されません。監視および管理の価格設定の詳細を参照してください。

OCIロギングを使用するためのポリシーの追加(OCI GoldenGate)

サービス・ログを有効にするには、ログ・グループに対する管理アクセス権とリソースへのアクセス権をユーザーに付与する必要があります。ログおよびログ・グループでは、log-groupリソース・タイプが使用されますが、ログの内容を検索するには、log-contentリソース・タイプを使用する必要があります。次のポリシーを追加します:

allow group <group-name> to manage log-groups in compartment <compartment-name>
allow group <group-name> to manage log-content in compartment <compartment-name>

Learn more about policies.

Oracle Cloudコンソールを使用したロギングの有効化

「デプロイメント」ページで、ロギングを有効にするデプロイメントを選択します。
「デプロイメントの詳細」ページで、「モニタリング」を選択します。
「監視」ページで、「ログ」までスクロール・ダウンします。
「ログ」表のいずれかのログの「アクション」メニューで、「ログの有効化」を選択します。
「ログの有効化」パネルの「コンパートメント」ドロップダウンで、コンパートメントを選択します。
ログ・グループの場合、次のことができます。
- ドロップダウンからグループを選択します。
- 新規グループを作成します
- 空白のままにすると、デフォルト・グループが自動的に割り当てられます。
「ログ名」に名前を入力します。
「ログの保存」で、ドロップダウンから月数を選択します。
「ログの有効化」をクリックします。

ステータスが「アクティブ」になるまで待機します。アクティブになると、プロセス・ログおよびエラー・ログの診断ログ機能がオンになります。プロセス・ログおよびエラー・ログは、OCI GoldenGateなどのOracle Cloud Infrastructureネイティブ・サービスからのものであるため、技術的には「サービス・ログ」です。

CLIを使用したOCIロギングの有効化

ログ・グループの作成

要求

oci --profile <profile_name> logging log-group create --compartment-id <compartment_ocid>
      --display-name <display_name>

応答

{ "opc-work-request-id": "<log-workrequest-ocid>" }

ログ・グループIDの取得

要求

oci --profile <profile_name> logging work-request get --work-request-id
      <log-workrequest-ocid>

応答

{  
    "data": {    
    "compartment-id": "<compartment_ocid>",    
    "id": "<log-workrequest-ocid>",    
    "operation-type": "CREATE_LOG_GROUP",    
    "percent-complete": 100.0,    
    "resources": [      
        {        
            "action-type": "CREATED",        
            "entity-type": "loggroup",        
            "entity-uri": "/logGroups/<log-group-ocid>",        
            "identifier": "<log-group-ocid>"      
        }    
    ],    "
    status": "SUCCEEDED",    
    "time-accepted": "2023-05-09T05:57:09.641000+00:00",    
    "time-finished": "2023-05-09T05:57:09.641000+00:00",    
    "time-started": "2023-05-09T05:57:09.641000+00:00"  
    }
}

ログ・オブジェクトの作成/有効化

要求

oci --profile <profile-name> logging log create --display-name <display-name> --log-group-id
      <log-group-ocid> --log-type SERVICE/CUSTOM --is-enabled true  --configuration file://path_to_json_file

JSONリクエスト・ペイロード

{  
    "compartment-id": "<compartment-ocid>",     
    "source":    
        {        
            "resource": "<GoldenGate-deployment-ocid>",            
            "service": "goldengate",            
            "source-type": "OCISERVICE",            
            "category": "error_logs/process_logs"      
        }    
}

応答

Response 
{  
    "opc-work-request-id": "<log-workrequest-ocid>"
}

OCIロギングの無効化

要求

oci --profile <profile_name> logging log update --is-enabled false --log-group-id <log-group-ocid> --log-id <log-ocid>

応答

{  
    "opc-work-request-id": "<log-workrequest-ocid>"
}

OCIログの検索

要求

oci --profile <profile_name> logging-search search-logs
      --search-query "search \"<compartment_ocid>/<log-group-ocid>/<log-ocid>\"" --time-start '2023-05-09 09:54' --time-end '2023-05-09 09:55'

応答

{  
    "data": {    
        "fields": null,    
        "results": [      
            {        
                "data": {          
                "datetime": 1683626095205,          
                "logContent": {            
                    "data": {              
                        "level": "INFO",              
                        "message": "Executing command '{\n    \"name\": \"report\",\n    \"reportType\": \"lag\",\n    \"thresholds\": [\n        {\n            \"type\": \"info\",\n            \"units\": \"seconds\",\n           \"value\": 0\n        }\n    ]\n}'",              
                        "processName": "adminsrvr",              
                        "resourceId": "<GoldenGate-deployment-ocid>"            
                    },            
                    "id": "20230509095455.2051683626095",            
                    "oracle": {              
                        "compartmentid": "<compartment-ocid>",              
                        "ingestedtime": "2023-05-09T09:55:05.889Z",              
                        "loggroupid": "<log-group-ocid>",              
                        "logid": "<log-ocid>",              
                        "tenantid": "<tenant-ocid>"            
                    },            
                    "source": "<GoldenGate-deployment-ocid>",            
                    "specversion": "1.0",            
                    "time": "2023-05-09T09:54:55.205Z",            
                    "type": "com.oraclecloud.goldengate.deployment.process_logs"          
                }        
            }      
        } ],    
        "summary": {      
            "field-count": null,      
            "result-count": 1    
        }  
    }
}

ログ・ステータスの取得

要求

oci --profile <profile_name> logging log get --log-group-id <log-group-ocid> --log-id
      <log-ocid>

応答

{  
    "data": {    
        "compartment-id": "<compartment-ocid>",    
        "configuration": {      
            "archiving": {        
                "is-enabled": false      
            },      
            "compartment-id": "<compartment-ocid>",      
            "source": {        
                "category": "process_logs",        
                "parameters": {},        
                "resource": "<GoldenGate-deployment-ocid>",        
                "service": "goldengate",        
                "source-type": "OCISERVICE"      
            }    
        },    
        "defined-tags": {      
            "Oracle-Tags": {        
                "CreatedBy": "<creater_email_id>",        
                "CreatedOn": "2023-05-09T06:24:30.279Z"      
            }    
        },    
        "display-name": "<display_name>",    
        "freeform-tags": {},    
        "id": "<log-ocid>",    
        "is-enabled": false,    "
        lifecycle-state": "INACTIVE",    
        "log-group-id": "<log-group-ocid>",    
        "log-type": "SERVICE",    
        "retention-duration": 30,    
        "tenancy-id": "<tenancy-ocid>",    
        "time-created": "2023-05-09T06:24:30.452000+00:00",    
        "time-last-modified": "2023-05-09T06:30:17.345000+00:00"  
    },  
    "etag": "cb5bb295-9954-4949-b33f-67d6da50f83f"
}

ログの削除

要求

oci --profile <profile_name> logging log delete --log-group-id <log-group-ocid> --log-id <log-ocid>

応答

{  
    "opc-work-request-id": "<log-workrequest-ocid>"
}

ログ・グループの削除

要求

oci --profile GGSTEST logging log-group delete --log-group-id <log-group-ocid>

応答

{  
    "opc-work-request-id": "<log-workrequest-ocid>"
}

OCIロギング・サービスでのOCI GoldenGateのロギングの有効化

ログ・グループを作成し、ロギング・サービスでサービス・ログを構成します(まだない場合は)。

ナビゲーション・メニューを開き、「監視および管理」.をクリックします「ログ・アナリティクス」で、「管理」をクリックします。
「管理の概要」ページの「リソース」で、「ログ・グループ」をクリックします。
作業する権限があるコンパートメントを選択し、「ログ・グループの作成」をクリックします。

「ログ・グループの作成」パネルが表示されます。
次を完了します:
- コンパートメント: ログ・グループを作成するコンパートメント。このフィールドは、コンパートメントの選択に基づいて事前入力されます。
- 名前: このログ・グループの名前。ログ・グループ名の最初のキャラクタは、文字にする必要があります。詳細は、ログ名およびログ・グループ名を参照してください。機密情報を入力しないでください。
- 説明: わかりやすい説明。
- (オプション)タグ付け情報を入力してください。
「作成」をクリックします。

「ログ・グループの詳細」ページが表示されます。
「ログ」をクリックします。
「サービス・ロギングの有効化」をクリックします。
「リソースの選択」で、次の手順を実行します。
1. 「リソース・コンパートメント」で、リソースのコンパートメントを選択します。
2. 「サービス」で、ドロップダウンからGoldenGateを選択します。
3. 「リソース」で、ドロップダウンからデプロイメントを選択します。
「ログの構成」で、次の手順を実行します。
1. 「ログ・カテゴリ」で、ドロップダウンから値を選択します。
2. 「ログ名」に、名前を入力します。
「拡張オプションの表示」を選択し、「ログの場所」で次を選択します:
1. 「コンパートメント」で、ログを保存するコンパートメントを選択します。
2. 「ログ・グループ」で、ドロップダウンからログ・グループを選択するか、新しいグループを作成します。
「ログ保持」で、ログを保持する月数を選択します。
「ログの有効化」をクリックします。

デプロイメント・バックアップ・ログ

OCI GoldenGateデプロイメントを手動でOracle Object Storageにバックアップしてから、そのバックアップをローカルにダウンロードできます。その後、デプロイメント・ログを検索して、状態の問題をトラブルシューティングできます。

手動バックアップを作成する方法について学習するには、デプロイメント・バックアップの管理を参照してください。

手動デプロイメント・バックアップには、GoldenGateデプロイメントの完全なディレクトリ構造とファイル(ログ・ファイルおよびトレイル・ファイルを含む)が含まれます。トラブルシューティングに役立つディレクトリおよびファイルは次のとおりです:

/etc: 構成
- /etc/ogg: パラメータ・ファイル
/var: ログ・ファイル、チェックポイント、トレイル・ファイルなど
- /var/checkpt: チェックポイント
- /var/data: トレイル・ファイル
- /var/report: レポート・ファイル
- /var/log: ログ・ファイル
  - ER-events.log
  - ggserr.log
  - restapi.log
  - adminsrvr.log
  - pmsrvr.log
  - distsrvr-stdout.log
  - recsrvr-stdout.log
  - distsrvr.log
  - recvsrvr.log
  - extract.log
  - replicat.log

診断の収集

診断を収集して、OCI GoldenGateデプロイメントに関する情報を分析または共有します。問題が発生した場合は、収集した情報をMy Oracle Supportと共有できます。

ノート:

この機能は、データ・レプリケーション・デプロイメントにのみ適用されます。

診断を収集する前に、OCIオブジェクト・ストレージ・バケットを作成してください。

デプロイメント診断を収集するには:

「デプロイメント」ページで、診断を収集するデプロイメントを選択します。
デプロイメントの「詳細」ページで、「アクション」メニューから「診断収集」を選択します。
「診断収集」パネルで、次のフィールドに情報を入力し、「診断収集」をクリックします:
1. 「バケット」ドロップダウンで、診断ファイルを保存するバケットを選択します。別のコンパートメントのバケットを選択する場合は、「コンパートメントの変更」をクリックします。
2. 「診断名接頭辞」に、診断ファイル名の接頭辞となる短縮名または数文字を入力します。
3. (オプション)システム・ログを収集する開始日を選択します。
4. (オプション)システム・ログを収集する終了日を選択します。
  
  ノート:
  OCI GoldenGateデプロイメント用に収集される診断では、デプロイメントの存続期間全体のGoldenGateログが含まれます。これは選択した開始日および終了日とは関係はありません。

「診断の収集」をクリックすると、「デプロイメント情報」カードの「GoldenGate」セクションの下に「診断」という名前の新しいフィールドが表示されます。診断zipファイルはダウンロード可能になるまで数分かかることがあります。使用可能になると、「ダウンロード」リンクが表示されます。

タイトルおよび著作権情報

Oracle and/or its affiliates.