Linux プラットフォームでのオープンソース Telegraf を使用したアプリケーションの監視

オープンソース Telegraf を使用して Linux プラットフォーム上のアプリケーションとオペレーティングシステムを監視するには、ヘルパースクリプトを使用します。

ヘルパースクリプトは、次のオペレーティングシステムでのみテストされています。

CentOS 7.x および CentOS 8.x
RHEL 7.x および RHEL 8.x
SUSE 12.x および SUSE 15.x
OEL7.x および OEL 8.x
Ubuntu 16.x、Ubuntu 18.x、Ubuntu 20.x、および Ubuntu 22.x
VMware Photon Linux

前提条件

jq パッケージをインストールします。詳細については、jq の公式ドキュメント (https://stedolan.github.io/jq/download/) を参照してください。
vCenter Server 仮想マシンを VMware Aria Operations で監視する場合は、VMware Tools のバージョンを確実に 10.2 以降にします。vmware-toolbox-cmd は、vCenter Server 仮想マシンにのみ必要です。
次のコマンドを実行し、次のパッケージを使用する権限があることを確認します。
- コマンド：/bin/bash、awk、sed、vmware-toolbox-cmd、jq、curl
- パッケージ：coreutils (chmod、chown、cat)、net-tools (ip、/dev/tcp、curl、wget)
現在、クラウドプロキシでは IPv4 のみがサポートされています。
VMware Aria Operations で、クラウドプロキシが起動し、オンラインになっていることを確認します。コレクタグループの場合、VMware Aria Operations で、アプリケーション監視の高可用性が有効なコレクタグループ内のクラウドプロキシが 1 つ以上起動し、オンラインになっていることを確認します。
unzip が 6.0-20.el7 以降であることを確認します。
uuidgen パッケージはエンドポイント仮想マシン/物理サーバ上に存在する必要があります。
エンドポイント仮想マシン/物理サーバは、クラウドプロキシのポート 8443 および 443、またはアプリケーション監視の高可用性が有効なコレクタグループの仮想 IP アドレスにアクセスできる必要があります。

手順

次の場所にあるクラウドプロキシからヘルパースクリプトをダウンロードします。https://<CloudProxy-IP>/downloads/salt/telegraf-utils.sh

注：上記で指定したコマンドおよび場所の <CloudProxy-IP> には、関連するクラウドプロキシ [IP アドレス] を使用します。アプリケーション監視の高可用性が有効なコレクタグループの場合は、仮想 IP アドレスを指定します。
スクリプトがダウンロードされているディレクトリに移動します。
Linux 仮想マシンに対するスクリプトの実行権限を有効にします。
```
chmod +x telegraf-utils.sh
```
ヘルパースクリプトを実行して、Telegraf の構成を更新します。
```
telegraf-utils.sh  opensource -c cloud_proxy_ip_or_collector_group_name -t token -d telegraf_conf_dir -e telegraf_bin_path -v vmwareariaoperations_ip_or_fqdn
    
Description of arguments:
      -c : [REQUIRED] cloud_proxy_ip_or_collector_group_name - Cloud Proxy IP or Collector Group Name
      
       -t : [REQUIRED] token - Auth Token of the user/account. For getting a new token:
          (https://<VMwareAriaOperations_IP>/suite-api/ or curl -ks -X POST https://<VMwareAriaOperations_IP>/suite-api/api/auth/token/acquire -H \"Content-Type: application/json\" -H \"Accept: application/json\" -d \"{\"username\":\"<VMwareAriaOperations_USER>\",\"password\":\"<VMwareAriaOperations_USER_PASSWORD>\"}\")
      -d : [REQUIRED] telegraf_conf_dir - Telegraf configuration directory and it is required argument. ex: /etc/telegraf/telegraf.d
      -e : [REQUIRED] telegraf_bin_path - Path of telegraf executable ex: /usr/bin/telegraf
      -v : [REQUIRED] vmwareariaoperations_ip_or_fqdn - IP/FQDN of VMware Aria Operations master node and required for on-prem.
      

Example: /bin/bash telegraf-utils.sh opensource -t gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq -v 10.10.10.100 -c 10.10.10.101 -d /etc/telegraf/telegraf.d -e /usr/bin/telegraf
 
```
注：ヘルパースクリプトを実行したら、指定した config ディレクトリ（ -d オプション）パスの cloudproxy-http.conf という名前のファイル内で、それぞれの構成が正しく設定されていることを確認します。詳細については、構成例を参照してください。管理対象の vCenter Server 仮想マシンの場合、以下のいずれかの理由により、管理対象外の構成が表示されることがあります。
- vCenter Server アダプタが、VMware Aria Operations で vCenter Server 仮想マシンの詳細にアクセスできない。VMware Aria Operations vCenter Server クラウドアカウントの構成後、少なくとも 1 ～ 2 回の収集サイクルの間待機してください。
- AUTHENTIFICATION_TOKEN or vROps_IP が正しくない。
注：デフォルトでは、 telegraf.conf ファイルで InfluxDB 出力プラグインが有効になっており、データが influxdb サーバに送信されるため、構成済みの influxdb サーバコメントがないことに関する警告メッセージがログに複数記録されないように、「[[outputs.influxdb]]」の行をコメントアウトする必要があります。次の警告メッセージが表示されます： W! [outputs.influxdb] When writing to [http://localhost:8086]: database "telegraf" creation failed: Post "http://localhost:8086/query": dial tcp [::1]:8086: connect: connection refused
例：#[[outputs.influxdb]]

注： telegraf.conf ファイルの入力プラグインが、対応するオペレーティングシステムに関連付けられていることを確認します。オペレーティングシステムの Telegraf 構成の詳細を参照してください。

Telegraf サービスを再起動します。

systemctl restart telegraf 
or
/usr/bin/telegraf -config /etc/telegraf/telegraf.conf -config-directory /etc/telegraf/telegraf.d

次のタスク

[管理対象仮想マシンオブジェクトの階層]：

vCenter Server 仮想マシンが VMware Aria Operations によって監視されている場合、オペレーティングシステムおよびアプリケーションオブジェクトは、それぞれの [仮想マシン] > [OS オブジェクト] > [「アプリケーションサービス」のインスタンス] に分類されます。

[VMware Aria Operations で監視されないマシン]：vCenter Server 仮想マシンまたは物理サーバが VMware Aria Operations によって監視されていない場合、オペレーティングシステムおよびアプリケーションのオブジェクトは、[環境] > [エンドポイント] > [OS オブジェクト] > [「アプリケーションサービス」のインスタンス] に分類されます。

[収集されたデータの表示]：データが収集され、[Telegraf エージェントの管理] 画面に表示されます。詳細を表示するには、[Telegraf エージェントの管理] 画面で [Agent の種類] > [ソースエージェントを開く] の順に選択してフィルタリングします。