ログを表示、検索、管理する
項目一覧
- Cloud Managerへのプログラムによるアクセスのための OAuth 2.0認証はプレビュー機能として利用できます。
- 機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。 OAuth2.0 認証を使用するには、 Cloud Manager Public APIへのリクエストで使用する サービス アカウント を作成します。
Cloud Manager は、MongoDB プロセスとそのエージェントの両方のログ情報を収集します。 For MongoDB processes, you can access both real-time logs and on-disk logs.
MongoDB リアルタイム ログ
MongoDB Agent は、モニタリング ping ごとにgetLog
コマンドを発行します。 このコマンドは、各 MongoDB プロセスの RAM キャッシュからログ エントリを収集します。
Cloud Manager では、デフォルトでリアルタイム ログ収集が有効になります。 Cloud Manager プロジェクト内のすべての MongoDB 配置または個々の MongoDB 配置のログ収集を無効にできます。 ログ収集を無効にすると、Cloud Manager は以前に収集されたログ エントリを引き続き表示します。
MongoDB リアルタイム ログの表示
MongoDB Cloud MongoDB Cloud ManagerManagerで、プロジェクトのGo {0 ページにGoします。Deployment
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの Deployment をクリックします。
配置ページが表示されます。
Processesページに移動します。
配置の [ Processes ] タブをクリックします。
[プロセス ]ページが表示されます。
(任意)シャーディングされたクラスターでは、どのプロセス タイプが表示されるかをフィルタリングします。
4 つのボタンは、左から右に Shards、Configs、Mongos、BIs の順に並んでいます。
プロセス | 表示 |
---|---|
Shards | データをホストするmongodプロセス。 |
Configs | シャーディングされたクラスターのメタデータを保存するためのコンフィギュレーション サーバー として実行される mongod プロセス。 |
Mongos | シャーディングされたクラスターでデータをルーティングするmongosプロセス。 |
BIs | シャーディングされたクラスター内のデータにアクセスする BI プロセス。 |
配置のログ収集の有効化または無効化
MongoDB Cloud ManagerGoDeploymentMongoDB Cloud Managerで、プロジェクトの ページにGoします。
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの Deployment をクリックします。
配置ページが表示されます。
Processesページに移動します。
配置の [ Processes ] タブをクリックします。
[プロセス ]ページが表示されます。
[0} Xをクリックして Monitoring Settingsボックスを閉じます。
ログ収集をオフにすると、既存のログエントリはLogsタブに残りますが、Cloud Manager は新しいエントリを収集しません。
プロジェクトのログ収集の有効化または無効化
MongoDB Cloud ManagerGoMongoDB Cloud Managerで、Project Settings ページにGoします。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Projects メニューの横にある Options メニューをクリックし、 Project Settings をクリックします。
[ Project Settings ]ページが表示されます。
MongoDB ディスク上のログ
Cloud Manager は、MongoDB インスタンスが実行されていない場合でも、ディスク上のログを収集します。 MongoDB Agent は、 MongoDB systemLog.path
構成オプションで指定したロケーションからログを収集します。 MongoDB ディスク上のログは、リアルタイム ログのサブセットであるため、冗長性は低くなります。
注意
systemLog.d destinationプロパティがsyslog
に設定されている場合、このオプションは配置された MongoDB プロセスでは使用できません。
ディスク上のログのログ ローテーションを構成できます。 Cloud Manager はデフォルトでログをローテーションします。
この手順では、Cloud Manager のシステム ログと監査ログの両方をローテーションします。
ログ ローテーションの構成
Cloud Manager は、MongoDB Agent が管理するクラスターのログをローテーションおよび圧縮できます。 MongoDB Agent が クラスターのみを監視する場合、そのクラスターのログは無視されます。
重要
MongoDB Enterprise バージョン 5.0 以降、および MongoDB Agent 11.11.0.7355 以降を実行している場合は、次の操作を実行できます。
サーバー ログと監査ログのローテーションに個別のルールを設定します。
Cloud Manager を使用して監査ログを圧縮および削除します。 セキュリティ上の理由から、Cloud Manager の外部で監査ログの圧縮と削除を管理することをお勧めします。
MongoDB Enterprise または MongoDB Agent の以前のバージョンを実行している場合、Cloud Manager は次のように動作します。
System Log Rotation設定を使用して、サーバーログと監査ログの両方をローテーションします。
監査ログを圧縮または削除しません。 圧縮と削除を設定すると、Cloud Manager はこれらの設定をサーバー ログにのみ適用します。
MongoDB Community ユーザーは、サーバー ログのみをローテーション、圧縮、削除できます。
注意
この機能を使用する場合は、 logrotate
などのプラットフォームベースのログ ローテーション サービスを無効にします。 プロセス構成ファイルからreopen
とrename
フラグを削除します。 MongoDB Agent がクラスターのみを監視する場合、そのクラスターはプラットフォームベースのサービスを使用する可能性があります。
MongoDB Cloud ManagerGoDeploymentMongoDB Cloud Managerで、プロジェクトの ページにGoします。
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの Deployment をクリックします。
配置ページが表示されます。
ログ ローテーション を有効にします。
System Log RotationをONに切り替えて、サーバーログをローテーションします。
MongoDB Enterprise バージョン 5.0 以降と MongoDB Agent 11.11.0.7355 以降を実行している MongoDB Enterprise ユーザーは、 Audit Log RotationをONに切り替えて、監査ログをローテーションし、 監査ログ ローテーションを個別に構成することもできます。
MongoDB Enterprise または MongoDB Agent の以前のバージョンを実行している場合は、 System Log RotationをONに設定すると、監査ログもローテーションされます。
Cloud Manager によるログのローテーションが必要な場合は、ログ ローテーションをOFFに設定します。 ログ ローテーションはデフォルトでOFFです。
ログ ローテーションを有効にすると、Cloud Manager に追加のログ ローテーション設定が表示されます。
ログ ローテーション 設定を構成します。
Cloud Manager は、次の設定に従って MongoDB ホスト上のログをローテーションします。
フィールド | 必要性 | アクション | default |
---|---|---|---|
Size Threshold (MB) | 必須 | Cloud Manager は、この最大ログファイル サイズを超えるログファイルをローテーションします。 | 1000 |
Time Threshold (Hours) | 必須 | Cloud Manager は、この期間を超えるログをローテーションします。 | 24 |
Max Uncompressed Files | 任意 | ログファイルは、このファイル数を超えるまで非圧縮のままになります。 Cloud Manager は、最も古いログファイルを最初に圧縮します。 この設定を空のままにすると、Cloud Manager はデフォルトの | 5 |
Max Percent of Disk | 任意 | ログファイルは、MongoDB ホストのログボリューム上のディスク領域のこのパーセンテージまでを消費する可能性があります。 Cloud Manager は、このディスクしきい値を超えると、最も古いログファイルを削除します。 この設定を空のままにすると、Cloud Manager はデフォルトの | 2% |
Total Number of Files | 任意 | ログファイルの合計数。 数値が指定されていない場合、ログファイルの合計数はデフォルトで 0 になり、他のRotate Logs設定によって決まります。 | 0 |
それが完了したら、 Saveをクリックして変更を確認します。
エージェント ログ
Cloud Manager は、すべての MongoDB エージェントのログを収集します。
エージェント ログの表示
MongoDB Cloud ManagerGoDeploymentMongoDB Cloud Managerで、プロジェクトの ページにGoします。
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの Deployment をクリックします。
配置ページが表示されます。
Agentsページに移動します。
配置の [ Agents ] タブをクリックします。
[エージェント ]ページが表示されます。
ログ エントリをフィルタリングします。
別のタイプのエージェントのログを表示するには、 Viewドロップダウン リストを使用します。
特定のホストまたは MongoDB プロセスのログを表示するには、化のアイコンをクリックして選択を行います。
フィルターをクリアするには、ツールアイコンをクリックし、 Remove Filtersをクリックします。
選択したログをダウンロードするには、鍵アイコンをクリックし、 Download as CSV Fileをクリックします。
注意
特定のエージェントのログを表示するには、次の方法もあります。
MongoDB Cloud Managerで、プロジェクトの Deployment ページにGoします。
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの Deployment をクリックします。
配置ページが表示されます。
配置の [ Agents ] タブをクリックします。
[エージェント ]ページが表示されます。
[All Agents] をクリックします。
エージェントの [ view logsをクリックします。
エージェントのログ ローテーションの構成
オートメーションを使用してクラスターを管理する場合は、この手順に従ってエージェント ログ ファイルのローテーションを構成します。
注意
オートメーションを有効にしていない場合に、エージェント構成ファイルでログ設定を手動で構成する方法については、次のドキュメントを参照してください。
MongoDB Cloud ManagerGoDeploymentMongoDB Cloud Managerで、プロジェクトの ページにGoします。
まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Deployment ページがまだ表示されていない場合は、サイドバーの Deployment をクリックします。
配置ページが表示されます。
Agentsページに移動します。
配置の [ Agents ] タブをクリックします。
[エージェント ]ページが表示されます。
ログ設定を編集します。
モニタリングエージェントまたはバックアップエージェントのログ設定を編集するには、 pencilアイコンをクリックします。
名前 | タイプ | 説明 | |
---|---|---|---|
Linux Log File Path | string | 条件付き: Linux ホストでログを記録します。 エージェントが Linux ホスト上でログを書込むパス。 推奨される値は次のとおりです。
| |
Windows Log File Path | string | 条件付き: Windows ホスト上のログ。 エージェントが Windows ホスト上でログを書込むパス。 推奨される値は次のとおりです。
| |
Rotate Logs | 切り替え | ログをローテーションするかどうかを選択するトグル。 | |
Size Threshold (MB) | integer | ログが自動的にローテーションされるサイズ。 デフォルト値は 1000 です。 | |
Time Threshold (Hours) | integer | ログが自動的にローテーションされる期間。 デフォルト値は 24 です。 | |
Max Uncompressed Files | integer | 任意。 現在のログファイルを含む、非圧縮にされるログファイルの最大数。 推奨値は 5 です。 | |
Max Percent of Disk | integer | 任意。 ログが消費する MongoDB ホスト上のディスク領域の最大パーセンテージ。 推奨値は 2% です。 | |
Total Number of Files | integer | 任意。 ログファイルの合計数。 数値が指定されていない場合、ログファイルの合計数はデフォルトで 0 になり、他のRotate Logs設定によって決まります。 |
完了したら、[ Save ] をクリックします。