重要
このページで説明されている機能は、パブリックプレビュー期間中、Atlas Infiniteクラスターでは現在サポートされていません。パブリックプレビューでサポートされている機能については、パブリックプレビューの可用性を参照してください。
M10+ Atlas クラスターを構成して、毎分ごとにシステムログを外部サービスにエクスポートできます。ログを外部サービスにエクスポートすると、一元的なログマネジメント、長期的な保持、既存のモニタリングおよび監視ツールとの統合が可能になります。
サポートされているログの種類
Atlas は次のログタイプのエクスポートをサポートしています。
mongodログmongosログmongod-auditログmongos-auditログ
エクスポートするログタイプを指定し、最大 10 のエクスポート パスを設定して、ログを複数の宛先に同時に送信できます。
重要
ログには機密情報が含まれる場合があります（ PII など）。外部サービスでのログのストレージと処理はユーザーが責任を負います。ログをエクスポートする前に Atlas が特定の情報をリダクションするには、MongoDBサポートにお問い合わせください。
Considerations
ログをエクスポートするには、
M10+クラスターが必要です。ログのエクスポートは、無料または共有階層のクラスターでは利用できません。この要件は、すべての階層のクラスターをサポートするアクティビティフィードイベントのエクスポートには適用するません。ログのエクスポートを設定するには、
Project OwnerまたはOrganization Ownerのアクセス権が必要です。各 Atlas ホストは通常、1 日あたり 1 GBのログを生成します。ログをエクスポートするには、 データ転送コストが発生します。具体的なデータ転送コストは、 宛先、リージョン、クラウドプロバイダーによって異なります。
クラスターのリージョンやクラウドプロバイダーに関係なく、ログのエグレスは Amazon Web Services
us-east-1の Atlas コントロールプレーンから送信されます。クラスターが AWSus-east-1にない場合、インターネットイーグレスのコストに加えて、リージョン間またはクラウド間のデータ転送による課金が発生します。データ転送コストの詳細については、「データ転送コスト。」を参照してください。ネットワークの問題または再試行により、外部サービスに重複するログエントリが発生する可能性があります。
障害対応と自動復旧
Atlas はログのエクスポートの失敗を自動的に取り扱い、手動での操作なしで復旧します：
リトライとサーキット ブレーカー
外部シンクへのログ配送が失敗した場合、Atlas は、デフォルトでエクスポネンシャルバックオフを使用して、最大 3 回まで自動的に再試行します。再試行の遅延は1秒から開始し、試行間に最大10秒まで倍になります。
5回連続の失敗後、サーキット ブレーカーが開き、繰り返しのリクエストでシンクに負荷が集中するのを防ぎます。サーキット ブレーカーは 5 分間開いたままになり、テスト書き込みを試行します。テストが成功すると、通常の操作が再開されます。失敗すると、サーキット ブレーカーが再び開きます。
各シンク構成には固有の独立したサーキットブレーカーがあります。そのため、1 つの統合で問題が発生しても、他の統合に影響しません。
デッドレターキュー (DLQ)
再試行が上限に達した場合、またはエラーが再試行不可能な場合 (無効な認証情報など)、Atlas は、失敗したログ イベントを、7 日間の保持期間でデッドレターキュー (DLQ) にキューします。DLQ は、シンクが利用できない間のデータ損失を防止します。
警告
DLQ から、7 日より古いログは永久に削除されます。シンクが 7 日以上アクセスできない状態が続く場合、そのログは復元できません。
接続が復元され、サーキット ブレーカーが閉じると、Atlas は DLQ からキューに入ったログを自動的にシンクに再生します。手動での介入は不要です。
警告
DLQ にログがキューに入っている間にシンク構成を変更する場合、キューに入っているログは再生されると新しい構成を使用します。例として、出力先をある S3 バケットから別のバケットへ変更した場合、キューに入ったログは元の出力先ではなく、新しいバケットに送信されます。
モニタリングとアラート
Atlas では、 ユーザーに自動的にメール通知を送信するProject Owner デフォルトのアラート が用意されています。これは、次の場合に送信されます。
ログのエクスポート時に、再試行不可能なエラーが発生します（DLQ にキューされたログ）。
複数回の再試行後にログのエクスポートが失敗しました（ログがDLQにキューイングされています）。
ログのエクスポートのリプレイでは、レコードを配送できません。
これらのアラートは情報であり、つまりプロジェクトアクティビティフィードにのみ表示されます。また、Project Alerts ページの Open Alerts または Closed Alerts タブには表示されません。情報アラートのライフサイクルについて学ぶには、アラートのワークフローを参照してください。
さらに、プロジェクト アクティビティフィード は、次の情報イベントをログします。
ログのエクスポートが復旧しました (キューに入ったログの再開準備が整いました)。
ログのエクスポートが回復しました (キューに格納されていたログが送信されています)。
キューに入れられたすべてのログが配信されました。
プロジェクトのアラート設定では、アラート受信者と通知方法をカスタマイズできます。詳細については、アラートの設定を参照してください。
サポートされているエクスポート先
次の表は、Atlas がログのエクスポートのためにサポートする外部サービスをまとめたものです。
目的地 | 説明 |
|---|---|
| |
| |
| |
| |
| |
|
サポートされているすべての出力先は、プロジェクトレベルのアクティビティフィード イベントをエクスポートできます。組織レベルのイベントのエクスポートは OpenTelemetry のみをサポートします。