AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

OpenTelemetry へのログのエクスポート

M10+ Atlas クラスターを構成して、毎分ごとにシステム ログを OpenTelemetry(OTel)にエクスポートできます。

この統合により、次のことが可能になります。

  • OTel エンドポイントとなる接続されたデバイスにエクスポートするMongoDBログファイルを指定します。Atlas は次のログタイプのエクスポートをサポートしています。

    • mongod

    • mongos

    • mongod-audit

    • mongos-audit

  • 最大 10 エクスポート パスを設定すると、ログを複数のエンドポイントとなる接続されたデバイスに同時にエクスポートできます。

重要

ログには機密情報が含まれる場合があります( PII など)。OTel エンドポイント内のログのストレージと処理はユーザーがする必要があります。ログをエクスポートする前に Atlas が特定の情報をリダクションするには、MongoDBサポートにお問い合わせください。

ログを OTel エンドポイントとなる接続されたデバイスにエクスポートするには、Atlas への Project Owner または Organization Owner アクセス権が必要です。

  • 各 Atlas ホストは通常、1 日あたり 1 GBのログを生成します。ログをエクスポートするには、 データ転送コストが発生します。具体的なデータ転送コストは、 宛先、リージョン、クラウドプロバイダーによって異なります。

  • ネットワークの問題または再試行により、OTel エンドポイントとなる接続されたデバイスに重複するログエントリが発生する可能性があります。

  • Atlas は TLS エンドポイントとなる接続されたデバイスに接続するときに TLS を強制し、公開認証局(CA)によって署名された証明書を必要とします。自己署名証明書はサポートされていません。

次のものが必要です。

  • 既存の OTel エンドポイントとなる接続されたデバイス。

  • エンドポイントとなる接続されたデバイスURLとポート。

  • 認証構成。

  • MongoDB 7.0 以降を実行中M10+ Atlas クラスター。

ログを OTel エンドポイントとなる接続されたデバイスにエクスポートするには、次の手順を実行します。

1
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

  3. サイドバーで、 アイコンを Project Overview の横にあるをクリックします。

[ Project Settings ]ページが表示されます。

2

[Integrations] タブをクリックします。

プロジェクト統合ページが表示されます。

3
4
  1. OTLP Endpointフィールドに、OTel プロバイダー アカウントに表示される OTel エンドポイントとなる接続されたデバイスのURLを入力します。

  2. OTLP Header フィールドに、OTel エンドポイントとなる接続されたデバイスが認証に必要なヘッダーと値を入力します。

  3. [Log Type で、エクスポートするログのタイプを選択します。

    • MongoDB Logs 各 mongod サーバープロセスによって書き込まれた診断ログ。サーバーのスタートアップとシャットダウン、構成、接続、低速クエリ、レプリケーション、シャーディングアクティビティ、およびその他の運用イベントがレコード。

    • MongoDB Audit Logs 認証試行、承認チェック、ロールの変更、その他のセキュリティ関連操作などのシステムイベントアクションを追跡する mongod によって発行される監査ログ。これらのログは、メインのMongoDBログとは別です。

    • MongoDB Router Logs シャーディングされたクラスター内の各mongosルーター プロセスによって書き込まれた診断ログ。シャードへのクエリのルーティング、シャーディングメタデータの更新、一般的なプロセス診断など、ルーター固有の動作をキャプチャします。

    • MongoDB Router Audit Logs mongos ルーター プロセスによって発行される監査ログ。同じ種類の監査されたシステム イベントを記録しますが、シャーディングされた配置では ルーターの観点から見たものを記録します。

    • Events Project Activity Feed からのイベント。統合ライフサイクルイベントやログのエクスポートステータスの変更など。詳細については、「アクティビティフィード イベントを外部ツールへエクスポート」をご覧ください。

    MongoDB ログの詳細については、「MongoDB ログの表示とダウンロード」を参照してください。

  4. エクスポートを有効にする前に、Validate をクリックして、構成と認証情報が正しいことを確認してください。

  5. [Save] をクリックします。

組織レベルのOpenTelemetry統合では、データベースのログではなくアクティビティフィードのイベントがエクスポートされます。組織イベントのエクスポートは、OTel互換の宛先のみをサポートしています。

組織のイベントをエクスポートするには、AtlasへのOrganization Ownerアクセス権が必要です。

組織のイベントをOTelエンドポイントとなる接続されたデバイスにエクスポートするには、次の手順を実行します。

1
  1. まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. サイドバーで、Organization Settings をクリックします。

[ Organization Settings ]ページが表示されます。

2

[Integrations] タブをクリックします。

[組織統合 ]ページが表示されます。

3
4
  1. OTLP Endpointフィールドに、OTel プロバイダー アカウントに表示されるとおりに OTel エンドポイントとなる接続されたデバイスの URL を入力します。エンドポイントとなる接続されたデバイスは、公開の認証局(CA)によって署名された証明書を使用して HTTPS を使用する必要があります。

  2. OTLP Header フィールドに、OTel エンドポイントとなる接続されたデバイスが認証に必要とするヘッダーと値を入力します。最大 10 個のヘッダーを指定でき、合計サイズは最大 2 KB です。

  3. エクスポートを有効にする前に、Validate をクリックして、構成と認証情報が正しいことを確認してください。

  4. [Save] をクリックします。

Atlasは、すべてのプロジェクトで有効になっているデフォルトのアラートを通じて、ログのエクスポートが失敗または復旧したときに自動的に通知します。

外部ログシンクを持つすべてのプロジェクトでは、以下のアラートがデフォルトで有効になっています。

これらのアラートは情報であり、アラート条件が満たされると、Atlas は Project Owner ロールを持つすべてのユーザーにメール通知を直ちに送信し、アラートを Project Activity Feed にログします。これらのアラートは、Project Alerts ページの Open Alerts タブまたは Closed Alerts タブに表示されません。Project Alerts 設定で、通知の受信者および方法をカスタマイズできます。情報アラートのライフサイクルについて詳しくは、アラートワークフローを参照してください。

アラートに加えて、Atlas は次の情報イベントを Project Activity Feed にログに記録します。

  • Log export has recovered. Queued logs are ready to resume sending.

  • Log export has recovered. Queued logs are now being sent.

  • All queued logs have been delivered to sink.

これらのイベントを表示するには、「アクティビティフィードを表示」を参照してください。

アラート通知の構成の詳細については、「アラートの構成」を参照してください。