データベース監査を設定する

必要なアクセス権

監査ログを構成するには、更新するプロジェクトへの Project Owner アクセス権、または更新するプロジェクトを含む組織への Organization Owner アクセス権が必要です。

To learn about recommendations for auditing and logging, including the events that we recommend auditing, see Guidance for Atlas Auditing and Logging in the Atlas Architecture Center.

プロジェクト内のすべてのクラスターでデータベース監査が有効になっているように強制するには、 Atlas リソース ポリシー を使用します。クラスターを作成または変更する前に、リソースポリシー を使用して、データベース監査を要求できます。

手順

データベース監査を設定するには、次の手順に従います。

To retrieve the audit logs in Atlas, see MongoDB Logs. To retrieve the audit logs using the API, see Logs.

カスタム監査フィルターを構成する

Atlas は、MongoDB Auditing をカスタマイズする JSON 形式の監査フィルターの指定をサポートしています。

Custom audit filters let users forgo the managed Atlas UI auditing filter builder in favor of hand-tailored granular control of event auditing. Atlas checks only that the custom filter uses valid JSON syntax, and doesn't validate or test the filter's functionality.

監査フィルター ドキュメントは、監査イベント メッセージ内の 1 つ以上のフィールドに一致するクエリに解決される必要があります。フィルター ドキュメントでは、必要な監査メッセージを一致させるために、クエリ演算子と等価条件の組み合わせを使用できます。

To view example auditing filters, see Example Auditing Filters. To learn more about configuring MongoDB auditing filters, see Configure Audit Filter.

監査フィルターの例

独自のフィルターを作成する際のガイドとして、次の監査フィルターの例を使用してください。

{
  "atype": "authenticate"
}

{
  "$or": [
    {
      "users": []
    },
    {
      "atype": "authenticate"
    }
  ]
}

{
  "atype": "authenticate",
  "param": {
    "user": "myClusterAdministrator",
    "db": "admin",
    "mechanism": "SCRAM-SHA-256"
  }
}

{
  "atype": "authCheck",
  "param.command": {
    "$in": [
      "insert",
      "update",
      "delete"
    ]
  }
}

{
  "atype": {
    "$in": [
      "createUser",
      "dropUser",
      "directAuthMutation"
    ]
  }
}

監査するログのモニタリングエージェント クエリ

データベース監査を有効にすると、監査ログに mms-monitoring-agent ユーザーからのクエリが表示される場合があります。これらのクエリは、Atlas がモニタリング機能のメトリクスとパフォーマンス データを収集するために使用する内部操作です。

The mms-monitoring-agent user has the clusterMonitor and directShardOperations roles and performs queries on behalf of the following Atlas monitoring features:

• クエリインサイト: クエリパフォーマンスの統計と形状を収集し、低速クエリの特定に役立ちます。

• Namespace Insights: Gathers collection-level latency statistics using $collStats aggregation pipelines with latencyStats histograms.

• その他のパフォーマンス メトリクス: モニタリング ダッシュボードのデータベースとクラスターの統計を検索します。

{
  "atype": "authCheck",
  "ts": {
    "$date": "2025-11-20T13:44:20.201+00:00"
  },
  "users": [
    {
      "user": "mms-monitoring-agent",
      "db": "admin"
    }
  ],
  "roles": [
    {
      "role": "clusterMonitor",
      "db": "admin"
    },
    {
      "role": "directShardOperations",
      "db": "admin"
    }
  ],
  "param": {
    "command": "aggregate",
    "ns": "test_db.people_1234",
    "args": {
      "aggregate": "people_1234",
      "pipeline": [
        {
          "$collStats": {
            "latencyStats": {
              "histograms": true
            }
          }
        }
      ],
      "$readPreference": {
        "mode": "nearest"
      }
    }
  },
  "result": 0
}

Atlas CLI によるデータベースの監査を管理する

Atlas CLI を使用して、プロジェクトのデータベース監査構成を管理できます。

atlas auditing update [options]

atlas auditing describe [options]