重要
このページで説明されている機能は、public preview中に Atlas Infinite クラスターで現在サポートされていません。public previewでサポートされている機能については、「 パブリック プレビューの可用性 」を参照してください。
M10+ Atlas クラスターを構成して、毎分ごとにシステムログを外部サービスにエクスポートできます。ログを外部サービスにエクスポートすると、一元的なログマネジメント、長期的な保持、既存のモニタリングおよび監視ツールとの統合が可能になります。
サポートされているログの種類
Atlas は次のログタイプのエクスポートをサポートしています。
mongodログmongosログmongod-auditログmongos-auditログ
エクスポートするログタイプを指定し、最大 10 のエクスポート パスを設定して、ログを複数の宛先に同時に送信できます。
重要
ログには機密情報が含まれる場合があります( PII など)。外部サービスでのログのストレージと処理はユーザーが責任を負います。ログをエクスポートする前に Atlas が特定の情報をリダクションするには、 MongoDBサポート にお問い合わせください。
Considerations
ログのエクスポートを設定するには、
Project OwnerまたはOrganization Ownerのアクセス権が必要です。各 Atlas ホストは通常、1 日あたり 1 GBのログを生成します。ログをエクスポートするには、 データ転送コストが発生します。具体的なデータ転送コストは、 宛先、リージョン、クラウドプロバイダーによって異なります。
Log egress originates from the Atlas control plane in AWS
us-east-1, regardless of your cluster's region or cloud provider. If your cluster is not in AWSus-east-1, you incur cross-region or inter-cloud data transfer charges in addition to Internet egress costs. To learn more about data transfer costs, see Data Transfer Costs.ネットワークの問題または再試行により、外部サービスに重複するログエントリが発生する可能性があります。
障害処理と自動リカバリ
Atlas はログエクスポートの失敗を自動的に処理し、手動による介入なしで回復します。
再試行と循環ブレーク
外部シンクへのログ配信に失敗すると、Atlas はデフォルトで最大 3 回、指数バックオフで自動的に再試行します。再試行の遅延は 1 秒から開始され、試行間の最大 10 秒まで 2 倍に増えます。
5回連続の失敗後、サーキット ブレーカーが開き、繰り返しのリクエストでシンクに負荷が集中するのを防ぎます。サーキット ブレーカーは 5 分間開いたままになり、テスト書き込みを試行します。テストが成功すると、通常の操作が再開されます。失敗すると、サーキット ブレーカーが再び開きます。
各シンク構成には独自の回路ブレークがあるため、ある統合の問題は他の統合に影響することはありません。
デッド文字キュー(DLQ)
再試行が使い果たされた場合、またはエラーが再試行不可能な場合(無効な認証情報など)、エラーが発生した場合、Atlas は失敗したログイベントを デッド レター キュー(DLQ)に 60}7 日間の保持でキューに入れます。 DLQ は、Sink が使用できない間でもデータの損失を防ぎます。
警告
7 日以上経過したログはDLQ から完全に削除されます。 Sink にアクセスできない状態が 7 日以上続く場合、それらのログは回復できません。
接続が復元され、サーキット ブレーカーが閉じると、Atlas は DLQ からキューに入ったログを自動的にシンクに再生します。手動での介入は不要です。
警告
ログがDLQでキューに入れられているときにシンク構成を変更すると、キューに入れられたログは再生時に新しい構成で使用されます。例、ある S3バケットから別のバケットに宛先を変更すると、キューに入れられたログは元の宛先ではなく新しいバケットに送信されます。
モニタリングとアラート
Atlas は、次の場合に ユーザーにメール通知を自動的に送信するデフォルトのアラートを提供します。Project Owner
ログのエクスポートで再試行できないエラーが発生している(DLQ でキューに入れられたログ)。
ログのエクスポートは、複数回再試行すると失敗します(DLQ でキューに入れられたログ)。
ログ エクスポート リプレイでレコードが配信されない。
これらのアラートは情報提供であり、プロジェクト アクティビティ フィードにのみ表示され、 Open AlertsClosed AlertsProject Alertsページの タブまたは タブには表示されません。情報アラートのライフサイクルの詳細については、「 アラート ワークフロー 」を参照してください。
さらに、プロジェクト アクティビティ フィードには次の情報イベントが記録されます。
ログのエクスポートが復旧しました (キューに入ったログの再開準備が整いました)。
ログのエクスポートが回復しました (キューに格納されていたログが送信されています)。
キューに入れられたすべてのログが配信される。
プロジェクトのアラート設定 でアラートの受信者と通知方法をカスタマイズできます。詳細については、「 アラートの構成 」を参照してください。
サポートされているエクスポート先
次の表は、Atlas がログのエクスポートのためにサポートする外部サービスをまとめたものです。
目的地 | 説明 |
|---|---|
| |
| |
| |
| |
| |
|
サポートされているすべての宛先で、プロジェクト レベルのアクティビティ フィード イベントをエクスポートできます。組織レベルのイベントエクスポートは OpenTelemetry のみをサポートします。