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 仮想マシンを vRealize Operations Cloud で監視する場合は、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)
インターネットが有効になっていることを確認します。
vRealize Operations Cloud で、クラウドプロキシが起動し、オンラインになっていることを確認します。コレクタグループの場合、vRealize Operations Cloud で、アプリケーション監視の高可用性が有効なコレクタグループ内のクラウドプロキシが 1 つ以上起動し、オンラインになっていることを確認します。
アプリケーション監視の高可用性が有効なコレクタグループのクラウドプロキシまたは仮想 IP アドレスに、vCenter Server 仮想マシン、AWS EC2 インスタンス、Azure 仮想マシン、または物理サーバからアクセスできることを確認します。
uuidgen パッケージは、vCenter Server 仮想マシン、AWS EC2 インスタンス、Azure 仮想マシン、または物理サーバ上に存在する必要があります。

手順

エンドポイントにオープンソース Telegraf をインストールします。インスタンスがインストールされている場合は、この手順をスキップできます。Telegraf の新しいインスタンスをダウンロードしてインストールするには、公式ドキュメントを参照し、https://www.influxdata.com/time-series-platform/telegraf/およびhttps://portal.influxdata.com/downloads/ から対応する OS バージョンを検索します。
次の場所にあるクラウドプロキシからヘルパースクリプトをダウンロードします。https://<CloudProxy-IP>/downloads/salt/open_source_telegraf_monitor.sh

注：上記で指定したコマンドおよび場所の <CloudProxy-IP> に関連するクラウドプロキシ IP アドレス/FQDN を使用します。アプリケーション監視の高可用性が有効なコレクタグループの場合は、仮想 IP アドレスを指定します。
スクリプトがダウンロードされているディレクトリに移動します。
Linux 仮想マシンに対するスクリプトの実行権限を有効にします。
```
chmod +x open_source_telegraf_monitor.sh
```
ヘルパースクリプトを実行して、Telegraf の構成を更新します。
```
open_source_telegraf_monitor.sh  -t <SAAS_REFRESH_TOKEN> -d <TELEGRAF_CONFIG_DIR>  -c <CP_IP_OR_COLLECTOR_GROUP> -e <TELEGRAF_BIN_PATH> [ -g <GATEWAY_URL> -a <CSP_AUTH_URL> ]

Description of arguments:
SAAS_REFRESH_TOKEN - CSP Refresh Token of the user/account. For getting new token, follow - "User/Organization Settings >> My Account >> API Tokens >> Generate a New API Token". It's a mandatory parameter.
Example: gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq
TELEGRAF_CONFIG_DIR: Telegraf configuration directory. i.e value of --config-directory argument mentioned in telegraf service. ex: /etc/telegraf/telegraf.d
TELEGRAF_BIN_PATH - Path of telegraf binary ex: /usr/bin/telegraf
CP_IP_OR_COLLECTOR_GROUP - Mention the cloud proxy FQDN/IP address or the name of the application monitoring high availability activated collector group.
GATEWAY_URL - Optional argument to override default vROps SaaS gateway URL
CSP_AUTH_URL - Optional argument to override default CSP authentication URL
```
```
Example:
./open_source_telegraf_monitor.sh -v 10.192.0.1 -t UO2HafB0JMYiMmnppZIo2Zn5jCdDf1YeIXa0E7JXUPoUXF5HN6SK29kdJUibcJMg -c 10.192.0.100 -d /etc/telegraf/telegraf.d  -e /usr/bin/telegraf
```
注：ヘルパースクリプトを実行したら、指定した config ディレクトリ（ -d オプション）パスの cloudproxy-http.conf という名前のファイル内で、それぞれの構成が正しく設定されていることを確認します。詳細については、構成例を参照してください。管理対象 vCenter Server 仮想マシン、AWS EC2 インスタンス、または Azure 仮想マシンの場合、次のいずれかの理由により、管理対象外の構成が表示されることがあります。
- vRealize Operations Cloud では、vCenter Server 仮想マシン、AWS EC2 インスタンス、または Azure 仮想マシンの詳細が、vCenter Server、AWS、または Azure アダプタ別に表示されません。vRealize Operations Cloud vCenter Server クラウドアカウントの構成後、少なくとも 1 ～ 2 回の収集サイクルの間待機してください。
- SAAS_REFRESH_TOKEN が正しくない。
注： -d <TELEGRAF_CONFIG_DIR>：Telegraf 実行可能ファイルには、コマンドラインオプション --config-directory が設定されています。スクリプトを実行するときに、オプション -d の値セットを指定する必要があります。Linux の場合、値はサービスファイル /usr/lib/systemd/system/telegraf.service に含まれています。

注：デフォルトでは、 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 構成の詳細を参照してください。
vRealize Operations Cloud でサポートされているアプリケーションサービスがエンドポイントで実行されている場合に、このサービスを監視するには、Telegraf に必要な入力を使用して Telegraf の構成ファイルまたはディレクトリを更新します。
サポートされているアプリケーションサービスのリストについては、概要を参照してください。

構成のリストについては、サポートされているアプリケーションサービスの Telegraf 構成の詳細を参照してください。

サポート対象外のアプリケーションサービスの場合は、Telegraf の構成ファイルまたはディレクトリを Telegraf に必要な入力で更新します。詳細については、 https://docs.influxdata.com/telegraf/latest/plugins/inputs/を参照してください。

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

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

次のタスク

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

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

[管理対象外の仮想マシンオブジェクト階層]：vCenter Server 仮想マシン、AWS EC2 インスタンス、または Azure 仮想マシンが vRealize Operations Cloud によって監視されていない場合、オペレーティングシステムおよびアプリケーションは、[環境] > [オペレーティングシステムワールド] > [OS オブジェクト] > [「アプリケーションサービス」のインスタンス] に分類されます。