Docker エージェントとの連携

IBM Cloudで IBM Cloud Monitoring サービスのインスタンスをプロビジョンした後、 Monitoring ・ホストを 2 つの Docker できます。各環境でモニターするメトリックを構成できます。

1 つ以上のタグを各モニタリング・エージェントに関連付けることができます。タグは、TAG_NAME:TAG_VALUE としてフォーマットされるコンマ区切りの値です。ご使用の環境をモニターするときには、これらのタグを使用して、エージェントから取得可能なメトリックを識別できます。例えば、そのエージェントによって収集されるすべてのメトリックとともにサービスの名前と場所に関する情報を含めることができます。

監視エージェントを2つの Docker コンテナとして展開する

Linux ホスト上に標準の Docker コンテナとして監視エージェントを直接構成する場合、監視エージェントを正しく起動するために外部Linuxヘッダーをインストールする必要がある場合があります。

例えば、以下のコマンドを実行して、外部 linux ヘッダーをインストールする必要がある場合があります。

apt-get -y install linux-headers-$(uname -r)

コマンド * に *...-linuxkituname -r を返すコンテナーで MacOS を使用している場合は、これは利用できないということに注意してください。

次の手順に従って、2つの Docker コンテナに監視エージェントを設定し、 IBM Cloud Monitoring サービスのインスタンスにメトリクスを収集して転送します

アクセス・キーを取得します。詳しくは、IBM Cloud UI を使用したアクセス・キーの取得を参照してください。
パブリックまたはプライベートの取り込み URL を確認します。詳しくは、Collector エンドポイントを参照してください。

モニタリング・エージェントをデプロイします。以下のコマンドを実行します。

docker run -it --privileged --rm --name sysdig-agent-kmodule \
-v /usr:/host/usr:ro \
-v /boot:/host/boot:ro \
-v /lib/modules:/host/lib/modules \
quay.io/sysdig/agent-kmodule

モニター・エージェントを実行します。
```
docker run -d --name sysdig-agent \
--restart always \
--privileged \
--net host \
--pid host \
-e ACCESS_KEY=[MONITORING_ACCESS_KEY] \
-e COLLECTOR=[COLLECTOR_ENDPOINT] \
[-e TAGS=[TAG_DATA]]
-v /var/run/docker.sock:/host/var/run/docker.sock \
-v /dev:/host/dev \
-v /proc:/host/proc:ro \
-v /boot:/host/boot:ro \
--shm-size=512m \
quay.io/sysdig/agent-slim
```
説明
- MONITORING_ACCESS_KEY はインスタンスの取り込みキーです。
- COLLECTOR_ENDPOINT は、モニタリング・インスタンスを使用できるリージョンのパブリックまたはプライベートの取り込み URL です。エンドポイントを確認するには、Collector エンドポイントを参照してください。
- TAG_DATA は、TAG_NAME:TAG_VALUE 形式のコンマ区切りタグです。 1 つ以上のタグをモニタリング・エージェントに関連付けることができます。例えば、role:serviceX,location:us-south などです。

コンテナーは切り離しモードで実行されます。コンテナーの出力を確認するには、-d を削除してください。

CLI を使用したエージェントのバージョンの確認

エージェントのバージョンを確認するには、次のコマンドを実行します。

docker exec sysdig-agent /opt/draios/bin/dragent --version

CLI を使用したエージェントの状況の確認

エージェントの状況を確認するには、次のコマンドを実行します。

docker ps | grep sysdig-agent

docker ps -a を実行すると、実行中のすべてのコンテナーを表示できます。

実行中のコンテナーのリストが表示されます。 sysdig-agent という名前のコンテナーがリストされていることを確認します。

エージェント・ログの検索

エージェントログを表示するには、以下のコマンドを実行します

docker logs sysdig-agent

エージェントのログの表示

エラーを探すには、以下のコマンドを実行してログを表示します。

docker logs sysdig-agent 2>&1 | grep "error"

Docker エージェントの更新

Linux システムにコンテナとして展開されている監視エージェントを削除するには、以下の手順に従います

モニタリング・エージェントのコンテナーを停止します。以下のコマンドを実行します。
```
docker stop sysdig-agent
```
モニタリング・エージェントのコンテナーを削除します。以下のコマンドを実行します。
```
docker rm sysdig-agent
```
モニタリング・エージェントの最新バージョンを入手します。以下のコマンドを実行します。
```
docker pull sysdig/agent
```
エージェントをインストールします。詳細はこちらをご覧ください。

モニター・エージェント・コンテナーの削除

デプロイ済みのモニター・エージェントを削除するには、以下のステップを実行します。

モニタリング・エージェントのコンテナーを停止します。

以下のコマンドを実行します。
```
docker stop sysdig-agent
```
モニター・エージェント・コンテナーへの参照を削除します。
```
docker rm sysdig-agent
```