Docs Menu
Docs Home
/ /

AWS S3 バケットへのログのエクスポート

M10+Atlas クラスターは、1 分ごとにシステム ログをAWS S バケットにエクスポートするように構成できます。3

この統合により、次のことが可能になります。

  • S3 バケットにエクスポートするMongoDBログファイルを指定します。 Atlas は次のログタイプのエクスポートをサポートしています。

    • mongod

    • mongos

    • mongod-audit

    • mongos-audit

  • 最大10 エクスポート パスを設定すると、複数のAWS S3 バケットにログを同時にエクスポートできます。

  • CRAP ARN との統合を構成して、S マルチリージョン アクセス ポイント(CRAP)にログを送信します。現在、Atlas Administration APIを使用してのみ CRAP ARN を構成できます。 CRAP エイリアスはサポートされていません。3

重要

ログには機密情報が含まれる場合があります( PII など)。 AWS S3 バケット内のログのストレージと処理はユーザーがする必要があります。ログをエクスポートする前に Atlas で特定の情報を編集するには、 のログ編集を有効にする を参照してください。

AWS S3バケットにログをエクスポートするには、Atlas に対する Project Owner または Organization Owner アクセス権が必要です。

  • 各 Atlas ホストは通常、1 日あたり 1 GBのログを生成します。ログをエクスポートするには、 データ転送コストが発生します。具体的なデータ転送コストは、 宛先、リージョン、クラウドプロバイダーによって異なります。

  • ネットワークの問題または再試行により、 AWS S3 バケットに重複するログエントリが発生する可能性があります。

次のものが必要です。

  • sts:AssumeRole を持つAWS IAM ロール。これにより、Atlas はAWSリソースにアクセスでき、最大セッション期間は 12時間に設定されます。

  • 既存のAWS S3 バケット。

  • MongoDB 7.0 以降を実行中M10+ Atlas クラスター。

AWS S3 バケットにログをエクスポートするには、次の手順を実行します。

1
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

  3. サイドバーで、Project Settings をクリックします。

[ Project Settings ]ページが表示されます。

2

[Integrations] タブをクリックします。

プロジェクト統合ページが表示されます。

3
4
  1. Authorize an AWS IAM Role[ ドロップダウンから ARN を選択します。 ARN を追加するには、「 統合AWSアクセスのセットアップ 」を参照してください。

  2. [Next] をクリックします。

5
  1. Bucket Nameフィールドに、 AWSアカウントに表示される S3 バケットの名前を入力します。

  2. Prefixフィールドにディレクトリ名を入力して、 S3 バケットの内容を整理します。例、 と入力すると、エクスポートされたログを保存するためのlogs/ logsS3 バケットに ディレクトリが作成されます。

  3. [Log Type で、エクスポートするログのタイプを選択します。

    • MongoDB Logsmongodb.gz )各mongod サーバープロセスによって書き込まれた診断ログ。サーバーのスタートアップとシャットダウン、構成、接続、低速クエリ、レプリケーション、シャーディングアクティビティ、およびその他の運用イベントがレコード。

    • MongoDB Audit Logsmongodb-audit-log.gzmongod によって発行され、認証試行、認可チェック、ロールの変更、その他のセキュリティ関連操作などのシステムイベントアクションを追跡する監査ログ。これらのログは、メインのMongoDBログとは別です。

    • MongoDB Router Logsmongos.gz )シャーディングされたクラスター内の各 ルーターmongos プロセスによって書き込まれた診断ログ。シャードへのクエリのルーティング、シャーディングメタデータの更新、一般的なプロセス診断など、ルーター固有の動作をキャプチャします。

    • MongoDB Router Audit Logsmongos-audit-log.gz ) ルーター プロセスによって発行される監査ログ。同じ種類の監査されたシステム イベントを記録しますが、シャーディングされた配置ではmongos ルーターの観点から見たものです。

    詳しくは、 「 MongoDBログの表示とダウンロード 」を参照してください。

  4. (任意) S3 バケット内のログを暗号化する場合は、 フィールドにAWS KMS(Key Management Service)キー ARNKMS Key を入力します。詳細については、 「 AWS KMS によるカスタマー キーの管理 」を参照してください。

  5. [Next] をクリックします。

6
  1. をクリックして、Atlas によって生成されたアクセス ポリシーをコピーし、ファイル名:AtlasS3LogExportPolicy でローカルに保存します。

  2. Atlas によって生成された CLI コマンドをコピーし、ターミナルで コマンドを実行して、 AWS IAM ロールにアクセス ポリシーをアタッチします。

  3. エクスポートを有効にする前に、Validate をクリックして、構成と認証情報が正しいことを確認してください。

7

Atlas が外部シンクへのログのエクスポートを停止したときに通知されるようにするには、 プロジェクト レベルのアラートを構成します。

1
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

  3. ナビゲーション バーの Alerts アイコンをクリックします。

  4. Project ヘッダーの下の Alerts をクリックします。

プロジェクト アラートページが表示されます。

2
3

Condition/Metricドロップダウン メニューで、[ Log export is unable to export logs on this host ] を選択します。

4
  1. Add Notification Method セクションで、ロールのリストから [] を選択します。

  2. Add Notifier ドロップダウン メニューで、次の表に記載されているオプションから選択します。

    通知オプション
    説明

    Atlas プロジェクト

    プロジェクト内の特定のロールを持つユーザーに、メールまたはテキスト メッセージでアラートを送信します。

    デフォルトでは、Atlas プロジェクトがアラート受信者に設定されています。アラート送信先のロールと配信方法は構成できますが、2 番目の Atlas プロジェクトを受信者に追加することはできません。

    Atlas プロジェクトは、現在受信者リストに含まれていない場合にのみ、Add リストのオプションとして使用できます。

    1. [Select Role(s)] チェックボックスからアラートを受信するプロジェクトを選択するか、アラートを受信するプロジェクト内のすべてのユーザーを対象に [All Roles] を選択します。

    2. Atlas プロジェクトのユーザー アカウント ページで各ユーザーに設定された携帯電話番号にこれらのアラートを送信するには、[SMS] を選択します。

    3. Atlas プロジェクト ユーザーのアカウント ページで各ユーザーに設定されたメールアドレスにこれらのアラートを送信するには、[Email] を選択します。デフォルトでは Email がオンになっています。

    Atlas 組織

    組織内の特定のロールを持つユーザーに、メールまたはテキスト メッセージでアラートを送信します。

    1. [Select Role(s)] チェックボックスからアラートを受信する組織ロールを選択するか、アラートを受信する組織内のすべてのユーザーを対象に [All Roles] を選択します。

    2. アカウント ページで各 Atlas 組織ユーザーに設定された携帯電話番号にこれらのアラートを送信するには、[SMS] を選択します。

    3. アカウント ページで各 Atlas 組織ユーザーに設定されたメールアドレスにこれらのアラートを送信するには、[Email] を選択します。デフォルトでは Email がオンになっています。

    Atlas user

    指定された Atlas user にメールまたはテキスト メッセージでアラートを送信します。

    1. Atlas user のアカウント ページで設定された携帯電話番号にこれらのアラートを送信するには、[SMS] を選択します。

    2. Atlas user のアカウント ページで設定されたメールアドレスにこれらのアラートを送信するには、[Email] を選択します。デフォルトでは Email がオンになっています。

    メールアドレス

    メールアドレスにアラートを送信します。

    SMS

    携帯電話番号にアラートを送信します。Atlas はすべての句読点と文字を削除し、数字のみを使用します。米国またはカナダ以外のユーザーの場合は、Atlas が米国に拠点を置く011 Twilio をテキスト メッセージの送信に使用しているため、 と 国コード を含めてください。米国以外の国の電話番号には、代替として Google Voice の電話番号を使用します。

    たとえば、ニューヨークの携帯電話番号にアラートを送信するには、電話番号の前に01164と入力します。

    Slack

    Slackチャンネルにアラートを送信します。チャンネル名、およびAPIトークンまたは Bot トークンのいずれかを入力します。APIトークンを作成するには、 https://api.slack.com/webページをSlack。Slackの Bot ユーザーの詳細については、https://api.slack.com/bot-usersを参照してください。

    API または統合キーが必要な通知を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。

    • Atlas UI を通じてアラートを表示または編集します。

    • Atlas Administration API から通知するアラートを問い合わせます。

    PagerDuty

    アラートを PagerDuty アカウントに送信します。PagerDuty サービス キーのみを入力します。エスカレーション ルールとアラートの割り当てを PagerDuty で直接定義します。

    ユーザーは PagerDuty ダッシュボードからのみ PagerDuty アラートを確認できます。

    すべての新しい PagerDuty キーは Events API v2 を使用します。

    Events API v1 キーをお持ちの場合は、そのキーを Atlas で引き続き使用できます。

    API または統合キーが必要な通知を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。

    • Atlas UI を通じてアラートを表示または編集します。

    • Atlas Administration API から通知するアラートを問い合わせます。

    Datadog

    DataDog アカウントに DataDogイベントとしてアラートを送信します。

    Atlas はアラートが最初に開かれたときに、「エラー」イベントとしてアラートを送信します。その後の更新は「情報」イベントとして送信されます。アラートが閉じられたときには、「成功」イベントを送信します。

    1. API Key の下に DataDog API キーを入力し、[Validate Datadog API Key] をクリックします。

    2. API リージョンを入力します。

      Atlas は、Atlas UI で次の Datadog リージョンをサポートしています。

      • US1

      • US3

      • US5

      • EU1

      • AP1

      Datadog はデフォルトで US1 を使用します。

      DataDog のリージョンの詳細については、DataDog サイト を参照してください。

      API または統合キーが必要な通知を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。

      • Atlas UI を通じてアラートを表示または編集します。

      • Atlas Administration API から通知するアラートを問い合わせます。

    3. (任意)データベースメトリクスの追跡を有効にするには、Send Database MetricsOn に切り替えます。

    4. (任意)レイテンシ メトリクスの追跡を有効にするには、Send Collection Latency MetricsOn に切り替えます。

    5. (任意)クエリシェイプメトリクスの追跡を有効にするには、Send Query Shape MetricsOn に切り替えます。

    6. [Save] をクリックします。

    VictorOps

    VictorOps アカウントにアラートを送信します。

    VictorOps から英数字の APIキー を入力して、アラート用の VictorOps エンドポイントを統合します。API キーにダッシュを追加して、形式 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx と一致させます。たとえば、 489f7he7-790b-9896-a8cf-j4757def1161 のようにします。任意のルーティングキー を入力して、アラートを特定の VictorOps グループにルーティングします。VictorOps 構成をテストするには、[Post Test Alert] をクリックします。VictorOps 内でエスカレーション ルールとルーティング ルールを直接定義します。

    このオプションは、確認が必要なアラートにのみ使用できます。Atlas では、このサードパーティー モニタリング サービスから情報アラートを受け取ることができます。ただし、これらのアラートは外部サービス内で解決する必要があります。VictorOps ダッシュボードから VictorOps アラートの受信を確認します。

    API または統合キーが必要な通知を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。

    • Atlas UI を通じてアラートを表示または編集します。

    • Atlas Administration API から通知するアラートを問い合わせます。

    Opsgenie

    アラートを Opsgenie アカウントに送信します。Opsgenie API キーのみを入力します。エスカレーション ルールとアラートの割り当てを Opsgenie で直接定義します。

    このオプションは、確認が必要なアラートにのみ使用できます。Atlas では、このサードパーティー モニタリング サービスから情報アラートを受け取ることができます。ただし、これらのアラートは外部サービス内で解決する必要があります。Opsgenie ダッシュボードから Opsgenie アラートを確認します。

    API または統合キーが必要な通知を作成してから次の操作を行うと、キーは部分的に伏字で表示されます。

    • Atlas UI を通じてアラートを表示または編集します。

    • Atlas Administration API から通知するアラートを問い合わせます。

    Microsoft Teams

    Microsoft Teams チャネルに アダプティブ カード としてアラートを送信します。

    Microsoft Teams チャネルにアラート通知を送信するには、Microsoft Teamss 受信 Webhook を作成する必要があります。Webhook の作成後は、自動生成 URL を使用して、Atlas で Microsoft Teams 統合を構成できます。

    統合を設定するには、「Microsoft Teams との統合」を参照してください。

    Microsoft Teams の通知アラートを表示または編集すると、URL は部分的に伏せ字で表示されます。

    Webhook

    プログラムによる処理のためにエンドポイントに HTTP POST リクエストを送信します。リクエスト本文には、Atlas Administration API アラート リソースと同じ形式を使用する JSON ドキュメントが含まれています。

    このオプションは、統合ページで Webhook 設定を構成した場合にのみ使用できます。

    Webhook 通知のアラートを表示または編集すると、URL が部分的に編集され、シークレットは完全に伏字化された状態で表示されます。

    1. Webhook URL フィールドに、Webhook ベースのアラートのターゲット URL を指定します。

    2. (任意)シークレットを使用して Webhook 統合をセットアップする場合、[Webhook Secret] フィールドで Webhook ベースのアラートの認証シークレットを指定します。

  3. Recurrence セクションでは、ログエクスポートの失敗条件が 60 分以上続く場合にアラートをトリガーし、問題が解決されるまで 10080 分(7 日)ごとに再送信するように設定します。

    こうすることで、ログのエクスポート失敗が長時間にわたって失敗した場合に通知が行われ、一時的な問題の過剰な通知を回避できます。

5

アラートの設定の詳細については、「 アラートの構成 」を参照してください。

戻る

ログの検討とダウンロード

項目一覧