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

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

ヘルパースクリプトは、Windows Server 2012、2012 R2、2016、2019、および 2022 でのみテストされています。

前提条件

Windows PowerShell が 4.0 以降であることを確認します。
vCenter Server 仮想マシンを VMware Aria Operations で監視する場合は、VMware Tools のバージョンを確実に 10.2 以降にします。vmware-toolbox-cmd は、vCenter Server 仮想マシンにのみ必要です。
現在、クラウドプロキシでは IPv4 のみがサポートされています。
インターネットが有効になっていることを確認します。
VMware Aria Operations で、クラウドプロキシが起動し、オンラインになっていることを確認します。コレクタグループの場合、VMware Aria Operations で、アプリケーション監視の高可用性が有効なコレクタグループ内のクラウドプロキシが 1 つ以上起動し、オンラインになっていることを確認します。
vCenter Server 仮想マシン、AWS EC2 インスタンス、Azure 仮想マシン、または物理サーバは、クラウドプロキシのポート 8443 および 443、またはアプリケーション監視の高可用性が有効なコレクタグループの仮想 IP アドレスにアクセスできる必要があります。

手順

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

注：上記で指定したコマンドおよび場所の <CloudProxy-IP> には、関連するクラウドプロキシ [IP アドレス] を使用します。アプリケーション監視の高可用性が有効なコレクタグループの場合は、仮想 IP アドレスを指定します。

スクリプトのダウンロードが失敗し、要求が中止されました：SSL/TLS セキュアチャネルを作成できませんでした というメッセージが表示される場合は、Windows プラットフォームでスクリプトのダウンロードに失敗するに記載されている手順に従ってください。
スクリプトがダウンロードされているディレクトリに移動します。
ヘルパースクリプトを実行して、Telegraf の構成を更新します。
```
telegraf-utils.ps1  opensource -c cloud_proxy_ip_or_collector_group_name -t token -d telegraf_conf_dir -e telegraf_bin_path [-g gateway_url -a csp_auth_url]
    
Description of arguments:
      -c : [REQUIRED] cloud_proxy_ip_or_collector_group_name - Cloud Proxy IP or Collector Group Name
      -t : [REQUIRED] token - [REQUIRED] - CSP Refresh Token of the user/account. For getting a new token, follow - 
           User/Organization Settings >> My Account >> API Tokens >> Generate a New API Token.
           Example: gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq
      
      -d : [REQUIRED] telegraf_conf_dir - Telegraf configuration directory and it is required argument. ex: C:\Telegraf\telegraf-1.20.4\telegraf.d
      -e : [REQUIRED] telegraf_bin_path - Path of telegraf executable ex: C:\Telegraf\telegraf-1.20.4\telegraf.exe
      
      -g : [OPTIONAL] [SAAS-SPECIFIC] gateway_url - argument to override default VMware Aria Operations SaaS gateway URL
      -a : [OPTIONAL] [SAAS-SPECIFIC] csp_auth_url - argument to override default CSP authentication URL


Example: .\telegraf-utils.ps1 opensource -c 10.10.10.101 -t gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq -d C:\Telegraf\telegraf-1.20.4\telegraf.d -e C:\Telegraf\telegraf-1.20.4\telegraf.exe
```
注：ヘルパースクリプトを実行したら、指定した config ディレクトリ（ -d オプション）パスの cloudproxy-http.conf という名前のファイル内で、それぞれの構成が正しく設定されていることを確認します。詳細については、構成例を参照してください。管理対象の vCenter Server 仮想マシン、AWS EC2 インスタンス、または Azure 仮想マシンの場合、以下のいずれかの理由により、管理対象外の構成が表示されることがあります。
- VMware Aria Operations では、vCenter Server 仮想マシン、AWS EC2 インスタンス、または Azure 仮想マシンの詳細が、vCenter Server、AWS、または Azure アダプタ別に表示されません。VMware Aria Operations の構成後、少なくとも 1 ～ 2 回の収集サイクルの間、vCenter Server クラウドアカウントを待機している。
- SAAS_REFRESH_TOKEN が正しくない。
注：
- 構成パスにはスペースを使用しないでください。スペースを含むパスは、短縮名の表記として渡すことができます。たとえば、c:\PROGRA~1 は c:\Program Files を表します。
注： telegraf.conf ファイルの入力プラグインが、対応するオペレーティングシステムに関連付けられていることを確認します。オペレーティングシステムの Telegraf 構成の詳細を参照してください。

注：デフォルトゲートウェイ URL は https://www.mgmt.cloud.vmware.com/vrops-cloud で、デフォルト認証 URL は https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize です。認証 URL とゲートウェイ URL がデフォルトの設定と異なる場合は、適切な引数（-g および -a）を指定します。

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

telegraf.exe --config telegraf.conf --config-directory telegraf.d

または、Telegraf を Windows サービスにすることができます。

<Telegraf_executable_path> --config <Telegraf_config_file_path> --config-directory <Telegraf_config_directory_path> --service install net start telegraf

例：

& 'C:\Telegraf\telegraf-1.20.4\telegraf.exe'  --config 'C:\Telegraf\telegraf-1.20.4\telegraf.conf' --config-directory 'C:\Telegraf\telegraf-1.20.4\telegraf.d'  --service install
net start telegraf

次のタスク

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

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

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

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