機械翻訳について

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

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

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

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

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

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

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

ノート:

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

OCI GoldenGateでOCIロギングを使用するには、ポリシーを追加

サービス・ログを有効にするには、ログ・グループに対する管理アクセス権およびリソースへのアクセス権をユーザーに付与する必要があります。 ログおよびログ・グループでは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>

「ポリシーの詳細」。

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

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

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

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

1. ログ・グループの作成

   リクエスト

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

   レスポンス

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

2. ログ・グループ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"  
       }
   }

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

   リクエスト

   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>"
   }

4. 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>"
   }

5. 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    
           }  
       }
   }

6. ログ・ステータスの取得

   リクエスト

   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"
   }

7. ログの削除

   リクエスト

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

   レスポンス

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

8. ログ・グループの削除

   リクエスト

   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. 「管理の概要」ページの「リソース」で、「ログ・グループ」をクリックします。
3. 作業する権限があるコンパートメントを選択し、「ログ・グループの作成」をクリックします。

   「ログ・グループの作成」パネルが表示されます。

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

   「ログ・グループの詳細」ページが表示されます。

6. 「ログ」をクリックします。
7. 「サービス・ログの有効化」をクリックします。
8. リソースの選択の下で:
   1. 「リソース・コンパートメント」で、リソースのコンパートメントを選択します。
   2. 「サービス」の場合、ドロップダウンからGoldenGateを選択します。
   3. 「リソース」の場合、ドロップダウンからデプロイメントを選択します。
9. ログの構成の下で:
   1. 「ログ・カテゴリ」で、ドロップダウンから値を選択します。
   2. 「ログ名」に、名前を入力します。
10. 高度なオプションを表示を選択し、ログのロケーションで次のようにします:
    1. 「コンパートメント」で、ログを保存するコンパートメントを選択します。
    2. 「ログ・グループ」の場合、ドロップダウンからログ・グループを選択するか、新しいグループを作成します。
11. 「ログ・リテンション」で、ログを保持する月数を選択します。
12. 「ログの有効化」をクリックします。

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

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

手動バックアップの作成方法の詳細は、「デプロイメント・バックアップの管理」を参照してください。

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

• /etc: configuration
  • /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 Object Storageバケットの作成」を確認してください。

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

1. Deploymentsページで、診断を収集するデプロイメントを選択します。
2. デプロイメントの「詳細」ページで、「アクション」メニューから「診断の収集」を選択します。
3. 診断の収集パネルで、次のフィールドに入力し、診断の収集をクリックします:
   1. 「バケット」ドロップダウンから、診断ファイルを保存するバケットを選択します。 別のコンパートメントのバケットを選択する場合は、「コンパートメントの変更」をクリックします。
   2. 「診断名プレフィクス」には、診断ファイル名の前に短縮名または数文字を入力します。
   3. (オプション)システム・ログを収集する開始日を選択します。
   4. (オプション)システム・ログを収集する終了日を選択します。

      ノート:

      OCI GoldenGateデプロイメント用に収集された診断には、デプロイメントの存続期間全体に対するGoldenGateログが含まれ、選択した開始日と終了日には関係ありません。

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

ダウンロードが完了したら、ファイルを解凍し、その内容を確認します。

• /etc/ogg: パラメータ・ファイルが含まれます。
• /var/report: レポート・ファイルおよび破棄ファイルが含まれます。
• /var/log: ログ・ファイルが含まれます。
• ER-events.log: ExtractおよびReplicatイベントが含まれます。
• ggserr.log: OCI GoldenGateエラーが含まれます
• restapi.log: REST APIログが含まれます
• adminsrvr.log: 管理サービスのログが含まれます。
• pmsrvr.log: パフォーマンス・メトリック・サービス・ログが含まれます
• distsrvr.log: 分散サービスのログが含まれます。
• recvsrvr.log: レシーバ・サービスのログが含まれます
• extract.log: Extractプロセス・ログが含まれます
• replicat.log: Replicatプロセス・ログが含まれます。

---

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

Copyright ©2022,

Oracle and/or its affiliates.