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

サポートされている宛先

使用可能な宛先は、統合をプロジェクトまたは組織 のどちらに構成するかによって異なります。プロジェクトイベントのエクスポートは、すべてのログのエクスポート先をサポートします。最初のリリースでは、組織イベントのエクスポートは 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ログレコードです。レコードのリソースには、アクティビティservice.name フィードイベントストリームを識別する に設定された 属性が含まれているため、OTLmongodb-atlas-events コレクターはこれらのイベントを他のテレメトリとは別にルーティングできます。 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 の仕様