アクティビティフィードのイベントを外部ツールにエクスポートする

サポートされている送信先

利用可能な送信先は、プロジェクトまたは組織のどちらに対して統合を構成するかによって異なります。プロジェクトイベントのエクスポートは、すべてのログエクスポート先をサポートしています。初期リリースでは、組織イベントのエクスポートはOTel互換の送信先のみをサポートしています。

必要なアクセス権

• プロジェクトのイベントエクスポートを構成するには、プロジェクトへの Project Owner アクセス権が必要です。

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

プロジェクト イベント エクスポートの構成

プロジェクトレベルのイベントをエクスポートするには、送信先の構成手順に従い、プロンプトが表示されたら Log Type の下で Events を選択します。

• Amazon Web Services S3

• Azure BLOB ストレージ

• Datadog

• Google Cloud PlatformGoogle Cloud Platformストレージ

• OpenTelemetry

• Slack

Eventsをシステムログタイプと同じ統合で組み合わせることも、ログとイベント用に個別の統合を作成することもできます。

組織イベントのエクスポートを構成する

組織レベルの統合はイベントのみをエクスポートし、OTel互換の送信先のみをサポートします。組織レベルの統合を構成するには、「組織のアクティビティフィードイベントのエクスポート」を参照してください。

APIを使用してイベントエクスポートを構成する

イベントのエクスポートをプログラムで構成するには、Atlas Administration APIのログ統合エンドポイントとなる接続されたデバイスを使用します。イベントをエクスポートするには、logTypesを設定してEVENTSを含めます。

curl --header "Authorization: Bearer {ACCESS-TOKEN}" \     --header "Content-Type: application/json" \     --header "Accept: application/vnd.atlas.2025-03-12+json" \     --include \     --request POST "https://cloud.mongodb.com/api/atlas/v2/groups/{PROJECT-ID}/logIntegrations?pretty=true" \     --data '{       "type": "OTEL_LOG_EXPORT",       "logTypes": ["EVENTS"],       "otelEndpoint": "https://otel-collector.example.com:4318/v1/logs",       "otelSuppliedHeaders": [         {           "name": "Authorization",           "value": "Bearer token123"         }       ]     }'

curl --header "Authorization: Bearer {ACCESS-TOKEN}" \     --header "Content-Type: application/json" \     --header "Accept: application/vnd.atlas.preview+json" \     --include \     --request POST "https://cloud.mongodb.com/api/atlas/v2/orgs/{ORG-ID}/logIntegrations?pretty=true" \     --data '{       "type": "OTEL_LOG_EXPORT",       "logTypes": ["EVENTS"],       "otelEndpoint": "https://otel-collector.example.com:4318/v1/logs",       "otelSuppliedHeaders": [         {           "name": "Authorization",           "value": "Bearer token123"         }       ]     }'

{  "id": "66d9f3e1a2b3c4d5e6f70819",  "type": "OTEL_LOG_EXPORT",  "logTypes": ["EVENTS"],  "otelEndpoint": "https://otel-collector.example.com:4318/v1/logs",  "otelSuppliedHeaders": [    {      "name": "Authorization",      "value": "<redacted>"    }  ]}

イベント形式

Atlas は、OTLP/HTTP を介して、ユーザーの宛先にイベントを JSON ペイロードとして配送します。エクスポートされた各イベントは OTLP ログ レコードです。レコードのリソースには、アクティビティフィードイベントストリームを識別する mongodb-atlas-events に設定された service.name 属性が含まれています。このため、OTel コレクターはこれらのイベントを他のテレメトリーとは別々にルーティングできます。Atlas は、エクスポートされたイベントから null 値の属性を省略します。

エクスポートされた各イベントには、次のフィールドが含まれます。

次の例は、エクスポートされたプロジェクトイベントを示しています。

{  "timeUnixNano": "1788896817574000000",  "severityNumber": "SEVERITY_NUMBER_INFO",  "severityText": "INFO",  "body": {    "stringValue": "{\"_id\":\"6aa06631ba29fc2b0f206c32\",\"eventType\":\"/events/mms/alerts/alert_config_added_audit\",\"projectId\":\"62abb98d95a82610b74debc5\",\"createdDate\":1788896817574,\"resources\":[],\"eventPayload\":\"{\\\"targetAlertConfigId\\\": \\\"6aa06631ba29fc2b0f206c30\\\", \\\"targetAlertConfigEventType\\\": \\\"HOST_DOWN\\\", \\\"targetAlertConfigType\\\": \\\"HOST\\\"}\",\"source\":{\"sourceType\":\"USER\",\"sourceInfo\":{\"username\":\"Atlas Admin\"}}}"  },  "attributes": [    {      "key": "mongodb.event.id",      "value": { "stringValue": "6aa06631ba29fc2b0f206c32" }    },    {      "key": "mongodb.event.type",      "value": { "stringValue": "/events/mms/alerts/alert_config_added_audit" }    },    {      "key": "mongodb.project.id",      "value": { "stringValue": "62abb98d95a82610b74debc5" }    },    {      "key": "mongodb.event.payload.encoding",      "value": { "stringValue": "json" }    }  ]}

配信動作

• ニアリアルタイム。通常の状態では、Atlasはニアリアルタイムでイベントを配信します。バッチするは、約1分に1回フラッシュされます。

• 少なくとも1回の配信。Atlasは同じイベントを複数回配信する場合があります。一意の mongodb.event.id フィールドを使用してイベントを重複排除します。

• 停止時のバッファリング送信先が利用できない場合、Atlasはイベントをバッファリングし、配信を再試行します。Atlasは、配信されなかったイベントを最大7日間保持します。7日経過しても配信されないイベントは、完全に削除されます。

• 自動リプレイ、バックフィル、または障害アラートはありません。初期リリースでは、永続的な障害が発生した後にイベントが自動的にリプレイされることはなく、統合を構成する前に発生した過去のイベントがバックフィルされることもありません。永続的な障害が発生した後にイベントの再配信をリクエストするには、MongoDB サポートにお問い合わせください。

送信先の制限

価格

イベントエクスポートには、個別のSKUや機能ごとの料金はありません。ただし、イベントのエクスポートにはデータ転送料金が発生する場合があり、これは送信先、リージョン、クラウドプロバイダーによって異なります。詳細については、「データ転送コスト」を参照してください。

詳細

• アクティビティ フィードの表示

• システム ログを外部サービスへエクスポートする

• Atlas イベントタイプ

• Atlas Administration API の仕様