Linux でのホスト監視のセットアップ

このページでは、非 Kubernetes® Linux ホストをモニターするために Splunk AppDynamics インフラストラクチャコレクタをインストールおよび設定する方法について説明します。

Splunk AppDynamics インフラストラクチャコレクタは、Cisco AppDynamics Distribution of OpenTelemetry Collector を使用してデータを転送します。詳細設定については、Amazon EC2 での Cisco AppDynamics Distribution of OpenTelemetry Collector の展開（Linux）を参照してください。

Kubernetes Linux ホストをモニターするように Splunk AppDynamics インフラストラクチャコレクタを設定するには、「AppDynamics Collectors Settings」を参照してください。

次に、手順の概要を示します。

インストール要件を満たしていることの確認
構成ファイルの作成
ホストモニタリングのインストール
構成ファイルの更新
ホストモニタリングサービスの診断の表示
ホストモニタリングエンティティの観察

はじめる前に

ホストモニタリングをインストールする前に、次の要件を満たしていることを確認してください。

次のポートにアクセスできる。
- 4317（gRPC 経由での OTLP データの受信用）
- 4318（HTTP 経由での OTLP データの受信用）
- 13133（正常性チェック拡張機能）
- 55679（zPages 拡張機能）
- 9100（Prometheus ノードエクスポータ）
パッケージ管理 URL と Cisco AppDynamics Distribution of OpenTelemetry Collector エンドポイントを許可リストに登録した。

構成ファイルの作成

ホストモニタリングをインストールする前に、構成ファイルをホストに書き込む必要があります。

Cisco Cloud Observability UI から設定値を取得します。
1. Cisco Cloud Observability UI にログインします。
2. 左側のナビゲーションパネルを使用して、[Configure] > [Databases and Hosts] に移動します。
3. クレデンシャルセット名を入力し、[Generate] をクリックします。
4. このページは開いたままにします。

/opt/appdynamics/appdynamics.confファイルを作成します。前の手順からの設定値を指定します。

mkdir -p /opt/appdynamics 
touch /opt/appdynamics/appdynamics.conf 
cat > /opt/appdynamics/appdynamics.conf << EOF 
APPD_OTELCOL_CLIENT_ID=<client-id>
APPD_OTELCOL_CLIENT_SECRET=<secret>
APPD_OTELCOL_TOKEN_URL=<auth-endpoint>
APPD_OTELCOL_ENDPOINT_URL=<data-endpoint>
EOF

BASH

（オプション）プロキシを設定します。HTTP または HTTPS ベースのプロキシを使用している場合は、次の変数を /opt/appdynamics/appdynamics.conf に追加します。

変数	説明
`HTTP_PROXY`	HTTP ベースのプロキシを使用している場合は、この環境変数をプロキシの URL に設定します。例：`HTTP_PROXY="http://myproxy/"`。
`HTTPS_PROXY`	HTTPS ベースのプロキシを使用している場合は、この環境変数をプロキシの URL に設定します。例：`HTTPS_PROXY="https://myproxy/"`。

Linux のホストモニタリングのインストール

この手順を開始する前に、「構成ファイルの作成」の説明に従って /opt/appdynamics/appdynamics.conf ファイルを作成する必要があります。

Cisco Cloud Observability UI にログインします。
左側のナビゲーションパネルを使用して、[Configure] > [Databases and Hosts] に移動します。
ページの指示に従って、ホストモニタリングをインストールします。

ホストモニタリングパッケージは、次の 3 つの systemctl サービスをインストールします。

サービス	名前	設定ファイル
Splunk AppDynamics インフラストラクチャコレクタ	`appdinfracol.service`	`/opt/appdynamics/appdinfracol/conf/manager_config.yml`
Cisco AppDynamics Distribution of OpenTelemetry Collector	`appdotelcol.service`	`/opt/appdynamics/appdynamics.conf`（「構成オプション」を参照）
Prometheus ノードエクスポータ	`appdnodeexporter.service`	N/A

構成オプション

Cisco AppDynamics Infrastructure Collector

ホストモニタリングは、/opt/appdynamics/appdinfracol/conf/manager_config.yml ファイルに設定されている次の変数から設定を読み取ります。

変数	説明	デフォルト	注意
`log-level`	Cisco AppDynamics Infrastructure Collectorのロガーの詳細レベルを指定する文字列。使用可能な値：`fatal`、`error`、`warn`、`info`、`debug`。	`info`	-
`log-files-max-size-mb`	次のログファイルの最大サイズを MB 単位で Cisco AppDynamics Infrastructure Collector 定義します。ログファイルがこのサイズを超えると、ファイルがバックアップファイルにコピーされ、圧縮されます。	`10`	ホストのみ
`log-files-num-backups`	ディスクに保存するログバックアップの数を定義します。	`1`	ホストのみ
`mtls-enabled`	Cisco AppDynamics Infrastructure Collectorの Cisco AppDynamics Distribution of OpenTelemetry Collectorとの通信の mTLS を有効にします。少なくとも TLS 1.2 が必要です。以下の TLS/mTLS に関する注記を参照してください。	false	-
`tls-enabled`	Cisco AppDynamics Infrastructure Collectorの Cisco AppDynamics Distribution of OpenTelemetry Collectorとの通信の TLS を有効にします。少なくとも TLS 1.2 が必要です。以下の TLS/mTLS に関する注記を参照してください。	false	-

mTLS または TLS が有効になっている場合、 Cisco AppDynamics Infrastructure Collector は、ホスト上の次のファイルを検索します。

ファイルの場所	説明	注意
`/opt/appdynamics/appdinfracol/certs/ca/ca.pem`	認証局ファイルの場所。この場所でファイルが見つからない場合、Cisco AppDynamics Infrastructure Collectorはデフォルトでシステムの認証局に設定されます。	TLS および MTLS に適用可能
`/opt/appdynamics/appdinfracol/certs/client/client-key.pem`	mTLS が有効になっている場合のクライアント秘密キーの場所。	MTLS のみ
`/opt/appdynamics/appdinfracol/certs/client/client.pem`	mTLS が有効になっている場合のクライアント証明書の場所。	MTLS のみ

Cisco AppDynamics Distribution of OpenTelemetry Collector

ホストモニタリングは、/opt/appdynamics/appdynamics.conf ファイルに設定されている次の変数から設定を読み取ります。

変数	必須	[説明（Description）]
`APPD_OTELCOL_CLIENT_ID`	〇	Cisco Cloud Observability で認証するためのクライアント ID を定義します。
`APPD_OTELCOL_CLIENT_SECRET`	〇	Cisco Cloud Observability で認証するための秘密文字列をプレーンテキストで定義します。
`APPD_OTELCOL_TOKEN_URL`	〇	コレクタが Oauth2 トークンを取得する URL を定義します。
`APPD_OTELCOL_ENDPOINT_URL`	〇	コレクタがデータを送信するエンドポイントを定義します。
`APPD_OTELCOL_EXTRA_CONFIG`	[いいえ（No）]	上書きされた構成ファイルの場所を定義します。`APPD_OTELCOL_EXTRA_CONFIG` の値は、`--config=provider:` である必要があります。この場合のプロバイダーは `file`、`http`、`yaml` です。https://github.com/open-telemetry/opentelemetry-collector/blob/main/confmap/README.md を参照してください。この変数は、複数の構成ファイルをサポートするために使用されます。使用する必要がある追加の構成ファイルがある場合は、コレクターの構成を拡張およびオーバーライドするために使用できます。`APPD_OTELCOL_EXTRA_CONFIG` の値を指定して、コンテンツがデフォルトの構成ファイルにマージされる追加の構成ファイルの場所を定義できます。`APPD_OTELCOL_EXTRA_CONFIG` 追加の構成ファイルの内容が優先されます。同じ構成がデフォルトファイルに存在する場合、追加ファイルの構成によって上書きされます。上書きされた構成ファイルは、ユーザーがアクセスするフォルダーに配置する必要があります。`/opt/appdynamics`Cisco Cloud Observability ファイルが /opt/appdynamics フォルダーにない場合は、ユーザーにアクセス許可を付与する必要があります。 Cisco Cloud Observability

構成ファイルの更新

サービスの構成を更新するには、次を実行します。

/opt/appdynamics/appdynamics.conf ファイルを開きます。構成オプションを変更します。
次のコマンドを使用して、サービスを再起動します。
```
systemctl restart <service-name>
```
BASH

診断の表示

ステータスのチェック

サービスのステータスをチェックするには、次のコマンドを実行します。

systemctl status <service-name>

BASH

ログの確認

診断ログを表示するには、次のコマンドを実行します。

journalctl -u <service-name>

BASH

次のステップ

ホストモニタリングサービスが実行されると、ホストリソースに関連付けられたメトリックが自動的にプルされ、エンティティ中心のページを使用した [Observe] ページに入力されます。Cisco Cloud Observability UI でホストモニタリングエンティティの観察を行えるようになりました。

このドキュメントには、サードパーティのドキュメントへの参照が含まれています。Splunk AppDynamics はいかなる権利も所有しておらず、そのようなサードパーティのドキュメントの正確性または完全性について責任を負いません。

これらの資料で使用されているサードパーティの名前、ロゴ、マーク、および一般的な参照情報は、米国および/またはその他の国のそれぞれの所有者またはその関係会社の所有物です。このような参照情報の記載は、情報提供のみを目的としており、Splunk AppDynamics とサードパーティの関係を促進または示唆することを意図したものではありません。