カスタム・ログ

新規Oracle Cloud Infrastructureインスタンス

サポートされているオペレーティング・システムでは、作成時にエージェントを直接有効にできます。これを行うには、コンピュート・インスタンスの監視の有効化を参照してください。

既存のOracle Cloud Infrastructureインスタンス

サポートされているオペレーティング・システムがある既存のインスタンスの場合、監視を有効にする必要があります。コンピュート・インスタンスの監視の有効化を参照してください。

モニタリング・プラグインがすでに有効になっている場合は、18th. 9月までにエージェントをインストールするためにインスタンスに自動的にパッチが適用されます。それ以外の場合は、次の手動インストール手順に従います。

1. (Linux)次のオペレーティングシステムのエージェントをダウンロードします。
   • CentOS 7 RPM: https://objectstorage.us-phoenix-1.oraclecloud.com/n/axmjwnk4dzjv/b/unified-monitoring-agent-ol7-repo/o/unified-monitoring-agent-0.0.5.rpm
   • CentOS 8 RPM: https://objectstorage.us-phoenix-1.oraclecloud.com/n/axmjwnk4dzjv/b/unified-monitoring-agent-ol8-repo/o/unified-monitoring-agent-0.0.5.rpm
   • OEL7 RPM: https://objectstorage.us-phoenix-1.oraclecloud.com/n/axmjwnk4dzjv/b/unified-monitoring-agent-centos7-repo/o/unified-monitoring-agent-0.0.5.rpm
   • OEL8 RPM: https://objectstorage.us-phoenix-1.oraclecloud.com/n/axmjwnk4dzjv/b/unified-monitoring-agent-centos8-repo/o/unified-monitoring-agent-0.0.5.rpm
2. (Linux)次のコマンドを実行してRPMをインストールします。

   yum install -y <rpm-name>

1. (Windows) https://objectstorage.us-phoenix-1.oraclecloud.com/n/axmjwnk4dzjv/b/unified-monitoring-agent-windows-repo/o/unified-monitoring-agent-0.0.5.msiからエージェントをダウンロードします。
2. (Windows)昇格されたコマンド・プロンプト(管理者として実行)を開き、MSIコマンドを実行します(インストールが完了するまでに最大5分かかる場合があります)。

   C:\path\to\file\unified-monitoring-agent-0.0.2.msi

3. (Windows)前述のコマンドのより高度なバージョン(MSIインストールの問題をデバッグする)を実行するには、次のコマンドを実行します。

   msiexec /i "C:\path\to\file\unified-monitoring-agent-0.0.2.msi" /l*v "C:\unified-monitoring-agent_msi.log"

Oracle Cloud Infrastructure以外のインスタンス

1. 「既存のOracle Cloud Infrastructureインスタンス」と同じステップに従って、エージェントをインストールします。
2. 実行しているインスタンスのユーザーAPIキーを構成します。「API署名キーの生成方法」で説明されている手順に従って、ユーザーAPIキーを生成します。
   • (Linux)ステップ2 a..ociディレクトリとその内容を/etc/unified-monitoring-agentの下に配置します。
   • (Windows)ステップ2 a.ウィンドウではいくつかのステップが異なるため、適切なステップに従ってください。.ociフォルダとその内容をC:\oracle_unified_agentディレクトリに作成します。
3. 2で説明されている手順に従います。Oracle Cloud Infrastructure CLI構成ファイルでプロファイルを作成し、次のステップで変更した構成ファイルを作成します。
4. 2のステップに従います。Oracle Cloud Infrastructure CLI構成ファイルでプロファイルを作成し、このセクションのプロファイル(<profile-name>)に「UNIFIED_MONITORING_AGENT」という名前を付けてください。次に、統合モニタリング・エージェントがサービスでの認証に使用する構成の例を示します。

   [UNIFIED_MONITORING_AGENT]
   user=ocid1.user.region..aaa...
   fingerprint=<cert fingerprint>
   key_file=/path/to/ocifolder/.oci/private.pem
   tenancy=ocid1.tenancy.region..aaa...
   region=<instances region>
   pass_phrase="pashphrase1234"

systemdユニット

統合エージェントはsystemdユニットに基づいており、次のコンポーネントで構成されています。

1. unified - monitoring - agent.service:メインの統合モニタリング・エージェント・サービス。
2. unified-monitoring-agent_config_downloader.service:構成自動更新サービス。
3. unified-monitoring-agent_config_downloader.timer:指定されたランダム化された間隔で自動ダウンローダ・サービスをトリガーするタイマー・ユニット。
4. unified-monitoring-agent_restarter.path: (自動アップデータ・サービスによって新しい構成がダウンロードされているために)変更が検出された場合に、Unified Monitoring Agentによって構成のリロードをトリガーするパス・ユニット。

これらのsystemdユニットの正しい動作を確認するには、次のようにsystemctlコマンドを使用できます。

systemctl status <unit_name>

<unit_name>は、次のいずれかの値に置き換える必要があります。

1. unified-monitoring-agent.service
2. unified-monitoring-agent_config_downloader.service
3. unified-monitoring-agent_config_downloader.timer
4. unified-monitoring-agent_restarter.path

通常、これらのsystemctlコマンドでは、次のような出力が表示されます。

systemctl status unified-monitoring-agent.service
● unified-monitoring-agent.service - unified-monitoring-agent: Fluentd based data collector for Oracle Cloud Infrastructure SIEM
   Loaded: loaded (/usr/lib/systemd/system/unified-monitoring-agent.service; enabled; vendor preset: disabled)
   Active: active (running) since Tue 2020-09-29 13:54:03 UTC; 1min 37s ago
     Docs: https://docs.cloud.oracle.com/
  Process: 2337 ExecReload=/bin/kill -USR2 ${MAINPID} (code=exited, status=0/SUCCESS)
  Process: 2321 ExecStart=/opt/unified-monitoring-agent/embedded/bin/fluentd --log /var/log/unified-monitoring-agent/unified-monitoring-agent.log --daemon /var/run/unified-monitoring-agent/unified-monitoring-agent.pid --log-rotate-size 1048576 --log-rotate-age 10 $EXTRA_OPTIONS (code=exited, status=0/SUCCESS)
 Main PID: 2327 (fluentd)
   Memory: 66.3M (limit: 5.0G)
   CGroup: /system.slice/unified-monitoring-agent.service
           ├─2327 /opt/unified-monitoring-agent/embedded/bin/ruby /opt/unified-monitoring-agent/embedded/bin/fluentd --log /var/log/unified-monitoring-agent/unified-monitoring-agent.log --daemon /var/run/unif...
           └─2330 /opt/unified-monitoring-agent/embedded/bin/ruby -Eascii-8bit:ascii-8bit /opt/unified-monitoring-agent/embedded/bin/fluentd --log /var/log/unified-monitoring-agent/unified-monitoring-agent.lo...

systemctl status unified-monitoring-agent_config_downloader.service
● unified-monitoring-agent_config_downloader.service - unified-monitoring-agent Fluentd configuration downloader.
  Loaded: loaded (/usr/lib/systemd/system/unified-monitoring-agent_config_downloader.service; enabled; vendor preset: disabled)
  Active: inactive (dead) since Tue 2020-09-29 13:54:38 UTC; 1min 30s ago
 Process: 2333 ExecStart=/opt/unified-monitoring-agent/embedded/bin/ruby /opt/unified-monitoring-agent/embedded/bin/fluent_config_updater.rb -c /etc/unified-monitoring-agent/conf.d/ -b 10 (code=exited, status=0/SUCCESS)
Main PID: 2333 (code=exited, status=0/SUCCESS) 

systemctl status  unified-monitoring-agent_config_downloader.timer
● unified-monitoring-agent_config_downloader.timer - Run unified-monitoring-agent configuration automatic updater.
   Loaded: loaded (/usr/lib/systemd/system/unified-monitoring-agent_config_downloader.timer; enabled; vendor preset: disabled)
   Active: active (waiting) since Tue 2020-09-29 13:54:03 UTC; 3min 57s ago 

systemctl status  unified-monitoring-agent_restarter.path
● unified-monitoring-agent_restarter.path - "Monitor the /etc/unified-monitoring-agent/conf.d/ directory for changes"
   Loaded: loaded (/usr/lib/systemd/system/unified-monitoring-agent_restarter.path; enabled; vendor preset: disabled)
   Active: active (waiting) since Tue 2020-09-29 13:54:03 UTC; 4min 9s ago 

Systemctlコマンド出力の最も重要な部分は、LoadedおよびActiveフィールドです。すべてのシステム・ユニットについて、Loadedフィールドの値はloadedである必要があります。Activeフィールドには、次の値が必要です。

• active (running): unified - monitoring - agent.serviceユニットの場合。
• unified-monitoring-agent_restarter.pathおよびunified-monitoring-agent_config_downloader.timerユニットのactive (waiting)またはactive (running)。
• unified-monitoring-agent_config_downloader.serviceユニットのactive (running)またはinactive (dead)。後者の値の場合、フィールドMain PIDに値code=exited, status=0/SUCCESS)が含まれている必要があります。

プロセス

Unified Monitoring Agentの正しい動作をさらに確認する別の方法は、システムの実行中のプロセスを確認することです。Unified Monitoring Agentは、正常に動作すると、スーパーバイザプロセスとワーカープロセスの2つのプロセスを実行します。ターミナルで次のコマンドを実行すると、それらの存在を検証できます(出力例も示します)。

ps aux | grep unified-monitoring-agen[t]
root      2327  0.0  2.3 307704 40864 ?        Sl   13:54   0:00 /opt/unified-monitoring-agent/embedded/bin/ruby /opt/unified-monitoring-agent/embedded/bin/fluentd --log /var/log/unified-monitoring-agent/unified-monitoring-agent.log --daemon /var/run/unified-monitoring-agent/unified-monitoring-agent.pid --log-rotate-size 1048576 --log-rotate-age 10
root      2330  0.2  2.1 297456 38192 ?        S    13:54   0:03 /opt/unified-monitoring-agent/embedded/bin/ruby -Eascii-8bit:ascii-8bit /opt/unified-monitoring-agent/embedded/bin/fluentd --log /var/log/unified-monitoring-agent/unified-monitoring-agent.log --daemon /var/run/unified-monitoring-agent/unified-monitoring-agent.pid --log-rotate-size 1048576 --log-rotate-age 10 --under-supervisor

前述のように、2番目のプロセスに追加された–under-supervisorを除いて、まったく同じ引数を持つ2つのプロセスが実行されています。これはワーカー・プロセスを示しているため、このパラメータのないプロセスが監督者になります。

ログ

Unified Monitoring Agentのログは、/var/log/unified-monitoring-agent/unified-monitoring-agent.logにあります。このファイルには、Unified Monitoring Agent自体のログが含まれています。

システム関連のイベント(サービスの開始、サービスの停止など)を含まないエージェントのログ以外に、journald、systemdのシステム・ロギング・サービスからログを表示することもできます。ユニットに固有のシステム・ログを表示するには、次のようなjournalctlコマンドを使用できます。

journalctl -u <unit_name>

<unit_name>は、次のいずれかの値に置き換える必要があります。

1. unified-monitoring-agent.service
2. unified-monitoring-agent_config_downloader.service
3. unified-monitoring-agent_config_downloader.timer
4. unified-monitoring-agent_restarter.path

journalctl --since "2020-12-30 00:00:01" --until "2020-12-31 23:59:59"

journalctl -f

トラブルシューティングのシナリオ

問題: Unified Monitoring Agentがインストールされていません。

解決策:新しく作成したインスタンスの場合、エージェントの自動インストールには最大25分かかることがあります。この期間を過ぎるとインストールされない場合は、次の点を確認してください。

1. インスタンスのネットワーク接続性。
2. コンソールで監視を有効にするかどうか。

ログ・ファイル/var/log/oracle-cloud-agent/plugins/unifiedmonitoring/unifiedmonitoring.logで、Oracleクラウド・エージェントによる統合モニタリング・エージェントのインストールに関する情報を確認することもできます。

問題: Unified Monitoring Agentが実行されていないか、そのステータスがロード/アクティブでないか、スーパーバイザプロセスとワーカープロセスの両方が実行されていません。

解決策: Unified Monitoring Agentを再起動します。

systemctl restart unified-monitoring-agent

ログで問題を確認してください。

問題:構成が自動的にダウンロードされません。

解決策:「エージェントのインストールとエージェントのインストールの検証」のステップに従っていることを確認します。次のコマンドを実行して、自動構成アップデータ・サービスのジャーナルを参照します。

journalctl -u unified-monitoring-agent_config_downloader.service

問題:構成が自動的にリロードされません。

解決策:「エージェントのインストールとエージェントのインストールの検証」のステップに従っていることを確認します。すべてのユニットのジャーナルを調べます。

1. タイマーユニットは少なくとも1回実行されている必要があります。
2. 自動構成ダウンロード・サービスは、関連する時間単位によってトリガーされた後に実行する必要があります。ログから、構成がダウンロードされ、Unified Monitoring Agentの構成ディレクトリに抽出されていることを確認できます。このことは、ls -lhatR/etc/unified-monitoring-agentディレクトリ内のファイルをリストすることで確認することもできます。
3. Systemctl status unified-monitoring-agent_restarter.pathのステータスをチェックして、パス・ユニットがアクティブであることを確認してください。
4. Unified Monitoring Agentのジャーナルjournalctl - u unified-monitoring-agent_config_downloader.serviceを調べて、リロード・シグナルが受信されたことを確認します。このコマンドの出力は、「unified - monitoring - agentのリロード」を参照してください。

データ収集

Unified Monitoring Agentに関する問題をエンジニアが解決できるようにチケットを開く場合は、次のコマンドの出力を含めます。スーパーユーザー権限が必要になる場合があります。

yum info unified-monitoring-agent
rpm -ql unified-monitoring-agent |  xargs sha512sum
systemctl status --full unified-monitoring-agent.service
systemctl status --full unified-monitoring-agent_config_downloader.service
systemctl status --full unified-monitoring-agent_config_downloader.timer
systemctl status --full unified-monitoring-agent_restarter.path
journalctl -a --no-pager -u unified-monitoring-agent.service
journalctl -a --no-pager -u unified-monitoring-agent_config_downloader.service
journalctl -a --no-pager -u unified-monitoring-agent_config_downloader.timer
journalctl -a --no-pager -u unified-monitoring-agent_restarter.path

また、/var/log/unified-monitoring-agent/および/var/log/oracle-cloud-agent/の下にファイルのアーカイブを含めます。次のコマンドを使用して、これらのディレクトリのgzip圧縮tarアーカイブを作成できます。

tar cvzf agent_logs_$(date +%s).tar.gz /var/log/unified-monitoring-agent/ /var/log/oracle-cloud-agent/

If the Unified Monitoring Agent is running but it is showing erratic behavior, you can also include backtrace and memory profile information, by running the following command and including the files /tmp/sigdump-<integer>.log in your report (where <integer> is an integer with 1 to 6 digits, even though in rare cases it might have more than that).

ps aux | grep unified-monitoring-agen[t] | grep ruby | awk '{print $2}' | xargs kill -SIGCONT

このコマンドの動作は、Unified Monitoring AgentプロセスPIDを検出し、SIGCONTシグナルを送信することです。これにより、ダンプが/tmp/sigdump-<integer>.logに生成されます。

アンインストールと再インストール

次のコマンドを実行すると、エージェントの構成を削除せずにUnified Monitoring Agentを削除できます。

yum -y remove unified-monitoring-agent

エージェントの構成は/etc/unified-monitoring-agent/ディレクトリの下に残ります。Unified Monitoring Agentパッケージの今後の(再)インストールのために構成を保持しない場合は、手動で削除する必要があります。

# use the following command to print the contents of the agent's configuration directory
find /etc/unified-monitoring-agent/
# use the following command to remove the directory and all of its contents (this step cannot be undone)
rm -rf /etc/unified-monitoring-agent/

エージェントは、Oracle Cloudエージェントによって最大25分で自動的に再インストールされます。これを行うには、コンソールでインスタンスの監視を有効にする必要があることに注意してください。詳細は、コンピュート・インスタンスの監視の有効化を参照してください。

統合モニタリングエージェントのトラブルシューティングステップ

自動構成更新のトラブルシューティング・ステップ

Oracle Cloudエージェントのトラブルシューティング・ステップ

Oracle Cloudエージェントのログを確認します。Windows Server 2012r2または2016の場合、ログ・ファイルの場所は次のとおりです。

• C:\Users\OCA\AppData\Local\Local\OracleCloudAgent\agent.log
• C:\Users\OCAUM\AppData\Local\OracleCloudAgent\plugins\unifiedmonitoring\unifiedmonitoring.log (ランタイム・ログ)
• C:\Users\OCAUM\AppData\Local\OracleCloudAgent\plugins\unifiedmonitoring\unifiedmonitoring_msi.log (インストール・ログ)

Windows Server 2019のログ・ファイルの場所:

• C:\Windows\ServiceProfiles\OCA\AppData\Local\OracleCloudAgent\agent.log
• C:\Windows\ServiceProfiles\OCAUM\AppData\Local\OracleCloudAgent\plugins\unifiedmonitoring\unifiedmonitoring.log (ランタイム・ログ)
• C:\Windows\ServiceProfiles\OCAUM\AppData\Local\OracleCloudAgent\plugins\unifiedmonitoring\unifiedmonitoring_msi.log (インストール・ログ)

断続的にMSIインストールに失敗しました

1. MSIのインストールが中断され(システムのリブート、プロセスの強制終了など)、2回目の実行でmsiexec.exeプロセスは、作成したフォルダへのファイルハンドルを保持したままになります。
2. Ruby.exeが予期したとおりに終了しないため、MSIがメイン・エージェント・フォルダへのアクセスに失敗するアップグレード中(問題が急増)。これによりMSIが失敗し、システムがクリーンアップされ、エージェントの大部分が削除されます(ただし、位置やバッファ・ファイルは削除されません)。

どちらのインスタンスでも、2回目のインストールまたはインストールを介したOracle Cloudエージェントの実行により、この問題は解決されます。それでもこの状態でスタックしている場合は、次の手順を実行します。

1. タスクマネージャの[詳細]で、msiexecおよびrubyプロセスをすべて強制終了します。
2. C:\oracle_unified_agent to C:\oracle_unified_agent_oldの名前を変更します。
3. エージェントを再度インストールするか、Oracle Cloudエージェントがインストールされるのを待ちます。