データを収集するエージェントの設定( Windows/Linux/Mac )
寄稿者
Cloud Insights ではを使用します "Tegraf" 統合データを収集するエージェントとして。Telegraf はプラグインベースのサーバエージェントで、指標、イベント、ログの収集とレポートに使用できます。入力プラグインは、システム /OS に直接アクセスするか、サードパーティ API を呼び出すか、設定されたストリームをリスニングすることによって、エージェントに必要な情報を収集するために使用されます(例:) Kafka や StatsD など)を参照してください。出力プラグインは、収集した指標、イベント、およびログをエージェントから Cloud Insights に送信するために使用します。
Cloud Insights の現在のTelegrafバージョンは*1.24.0 *です。
|
正確な監査およびデータレポートを作成するためには、 * Network Time Protocol ( NTP; ネットワークタイムプロトコル) * または * Simple Network Time Protocol ( SNTP ) * を使用して、 Agent マシンの時刻を同期することを強くお勧めします。 |
|
エージェントをインストールする前にインストールファイルを確認する場合は、の項を参照してください チェックサムを検証する。 |
エージェントをインストールしています
サービスデータコレクタをインストールしていて、エージェントをまだ設定していない場合は、最初に適切なオペレーティングシステム用のエージェントをインストールするように求められます。このトピックでは、 Tegraf エージェントを次のオペレーティングシステムにインストールする手順について説明します。
エージェントをインストールするには、使用しているプラットフォームに関係なく、まず次の手順を実行する必要があります。
-
エージェントに使用するホストにログインします。
-
Cloud Insights サイトにログインし、 * Admin > Data Collectors * に移動します。
-
[+Data Collector ] をクリックして、インストールするデータコレクタを選択します。
-
ホストに適したプラットフォーム( Windows 、 Linux 、 macOS など)を選択します
-
プラットフォームごとに、残りの手順を実行します。
|
ホストにエージェントをインストールしたら、そのホストに再度エージェントをインストールする必要はありません。 |
|
サーバ /VM にエージェントをインストールすると、 Cloud Insights は、設定したデータコレクタからの収集に加えて、そのシステムからメトリックを収集します。これらの指標は、のように収集されます "「ノード」指標"。 |
|
プロキシを使用している場合は、 Tegraf エージェントをインストールする前に、お使いのプラットフォームのプロキシの手順をお読みください。 |
Windows の場合
前提条件
-
PowerShell がインストールされていること
-
プロキシの背後にいる場合は、「Windows *プロキシ・サポートの構成」セクションの手順に従う必要があります。
Windows 向けプロキシサポートを設定しています
|
プロキシを使用する環境の場合は、をインストールする前にこのセクションをお読みください。 |
|
次の手順は '_http_proxy/https_proxy_environment 変数を設定するために必要なアクションの概要を示しています一部のプロキシ環境では '_no_proxy 環境変数も設定する必要があります |
プロキシの背後にあるシステムの場合、 Telegraf エージェントをインストールする前に https_proxy および /or_http_proxy_environment 変数 * を設定するには、次の手順を実行します。
[System.Environment]::SetEnvironmentVariable(“https_proxy”, “<proxy_server>:<proxy_port>”, [System.EnvironmentVariableTarget]::Machine)
エージェントをインストールしています
-
エージェントアクセスキーを選択します。
-
エージェントのインストールダイアログからコマンドブロックをコピーします。クリップボードアイコンをクリックすると、コマンドをクリップボードに簡単にコピーできます。
-
PowerShell ウィンドウを開きます
-
コマンドを PowerShell ウィンドウに貼り付け、 Enter キーを押します。
-
コマンドは、適切なエージェントインストーラをダウンロードしてインストールし、デフォルト設定を行います。終了すると、エージェントサービスが再起動されます。コマンドには一意のキーがあり、 24 時間有効です。
-
[ 完了 ] または [ 続行 ] をクリックします
エージェントのインストール後、次のコマンドを使用してサービスを開始または停止できます。
Start-Service telegraf Stop-Service telegraf
エージェントをアンインストールしています
Windows でエージェントをアンインストールするには、 PowerShell ウィンドウで次の手順を実行します。
-
Tegraf サービスを停止して削除します。
Stop-Service telegraf sc.exe delete telegraf
-
証明書を信頼ストアから削除します。
cd Cert:\CurrentUser\Root //rm E5FB7B68C08B1CA902708584C274F8EFC7BE8ABC rm 1A918038E8E127BB5C87A202DF173B97A05B4996
-
バイナリ、ログ、およびコンフィグレーションファイルを削除するには、 _C : \Program Files\テレ グラムフォルダを削除します
-
レジストリから _SYSTEM\CurrentControlSet\Services\EventLog\Application\テレ グラムキーを削除します
Agent をアップグレードしています
テレグラムエージェントをアップグレードするには、次の手順に従います。
-
テレグラムサービスを停止および削除します。
Stop-Service telegraf sc.exe delete telegraf
-
レジストリから _SYSTEM\CurrentControlSet\Services\EventLog\Application\テレ グラムキーを削除します
-
DELETE_C : \Program Files\テレ グラム \テレ グラム af.conf_
-
DELETE_C : \Program Files\テレ グラム \テレ グラム af.exe_
RHEL および CentOS
前提条件
-
cURL 、 sudo 、 ping 、 sha256sum 、 openssl 、 dmidecode となります
-
プロキシの背後にある場合は、「RHEL / CentOS *用のプロキシサポートの設定」セクションの手順に従う必要があります。
RHEL / CentOS でのプロキシサポートの設定
|
プロキシを使用する環境の場合は、をインストールする前にこのセクションをお読みください。 |
|
次の手順は '_http_proxy/https_proxy_environment 変数を設定するために必要なアクションの概要を示しています一部のプロキシ環境では '_no_proxy 環境変数も設定する必要があります |
プロキシの背後にあるシステムの場合は、 Telegraf エージェントをインストールする前に、次の手順 * を実行します。
-
現在のユーザの https_proxy 変数と _http_proxy_environment 変数を設定します。
export https_proxy=<proxy_server>:<proxy_port> . /etc/default/テレ グラム af_ を作成し、 _https_proxy_/or_http_proxy_variable の定義を挿入します。
https_proxy=<proxy_server>:<proxy_port>
エージェントをインストールしています
-
エージェントアクセスキーを選択します。
-
エージェントのインストールダイアログからコマンドブロックをコピーします。クリップボードアイコンをクリックすると、コマンドをクリップボードに簡単にコピーできます。
-
Bash ウィンドウを開きます
-
Bash ウィンドウにコマンドを貼り付けて、 Enter キーを押します。
-
コマンドは、適切なエージェントインストーラをダウンロードしてインストールし、デフォルト設定を行います。終了すると、エージェントサービスが再起動されます。コマンドには一意のキーがあり、 24 時間有効です。
-
[ 完了 ] または [ 続行 ] をクリックします
エージェントのインストール後、次のコマンドを使用してサービスを開始または停止できます。
オペレーティングシステムで systemd ( CentOS 7+ および RHEL 7+ )を使用している場合:
sudo systemctl start telegraf sudo systemctl stop telegraf
オペレーティングシステムで systemd ( CentOS 7+ および RHEL 7+ )を使用していない場合:
sudo service telegraf start sudo service telegraf stop
エージェントをアンインストールしています
Bash 端末で RHEL または CentOS のエージェントをアンインストールするには、次の手順を実行します。
-
Telegraf サービスを停止します。
systemctl stop telegraf (If your operating system is using systemd (CentOS 7+ and RHEL 7+) /etc/init.d/telegraf stop (for systems without systemd support)
-
Tegraf エージェントを取り外します。
yum remove telegraf . 残っている設定ファイルまたはログファイルを削除します。
rm -rf /etc/telegraf* rm -rf /var/log/telegraf*
Agent をアップグレードしています
テレグラムエージェントをアップグレードするには、次の手順に従います。
-
テレグラムサービスを停止します。
systemctl stop telegraf (If your operating system is using systemd (CentOS 7+ and RHEL 7+) /etc/init.d/telegraf stop (for systems without systemd support)
-
前のテレグラムエージェントを削除します。
yum remove telegraf . link:#rhel-and-centos["新しいエージェントをインストールします"]。
Ubuntu と Debian
前提条件
-
cURL 、 sudo 、 ping 、 sha256sum 、 openssl 、 dmidecode となります
-
プロキシの背後にいる場合は、「Ubuntu / Debian *用のプロキシサポートの設定」セクションの手順に従う必要があります。
Ubuntu / Debian のプロキシサポートの設定
|
プロキシを使用する環境の場合は、をインストールする前にこのセクションをお読みください。 |
|
次の手順は '_http_proxy/https_proxy_environment 変数を設定するために必要なアクションの概要を示しています一部のプロキシ環境では '_no_proxy 環境変数も設定する必要があります |
プロキシの背後にあるシステムの場合は、 Telegraf エージェントをインストールする前に、次の手順 * を実行します。
-
現在のユーザの https_proxy 変数と _http_proxy_environment 変数を設定します。
export https_proxy=<proxy_server>:<proxy_port> . /etc/default/テレ グラムを作成し、 _https_proxy_/or_http_proxy_variable 以下の定義を挿入します。
https_proxy=<proxy_server>:<proxy_port>
エージェントをインストールしています
-
エージェントアクセスキーを選択します。
-
エージェントのインストールダイアログからコマンドブロックをコピーします。クリップボードアイコンをクリックすると、コマンドをクリップボードに簡単にコピーできます。
-
Bash ウィンドウを開きます
-
Bash ウィンドウにコマンドを貼り付けて、 Enter キーを押します。
-
コマンドは、適切なエージェントインストーラをダウンロードしてインストールし、デフォルト設定を行います。終了すると、エージェントサービスが再起動されます。コマンドには一意のキーがあり、 24 時間有効です。
-
[ 完了 ] または [ 続行 ] をクリックします
エージェントのインストール後、次のコマンドを使用してサービスを開始または停止できます。
オペレーティング・システムが systemd を使用している場合:
sudo systemctl start telegraf sudo systemctl stop telegraf
オペレーティングシステムが systemd を使用していない場合は、次の手順を実行します。
sudo service telegraf start sudo service telegraf stop
エージェントをアンインストールしています
Ubuntu または Debian でエージェントをアンインストールするには、 Bash ターミナルで次のコマンドを実行します。
-
Telegraf サービスを停止します。
systemctl stop telegraf (If your operating system is using systemd) /etc/init.d/telegraf stop (for systems without systemd support)
-
Tegraf エージェントを取り外します。
dpkg -r telegraf . 残っている設定ファイルまたはログファイルを削除します。
rm -rf /etc/telegraf* rm -rf /var/log/telegraf*
Agent をアップグレードしています
テレグラムエージェントをアップグレードするには、次の手順に従います。
-
テレグラムサービスを停止します。
systemctl stop telegraf (If your operating system is using systemd) /etc/init.d/telegraf stop (for systems without systemd support)
-
前のテレグラムエージェントを削除します。
dpkg -r telegraf . link:#ubuntu-and-debian["新しいエージェントをインストールします"]。
MacOS
前提条件
-
次に示すコマンドは、 cURL 、 sudo 、 openssl 、および shasum を使用できる必要があります
-
プロキシの背後にいる場合は、「* macOS *用プロキシサポートの設定」セクションの手順に従う必要があります。
macOS のプロキシサポートを設定しています
|
プロキシを使用する環境の場合は、をインストールする前にこのセクションをお読みください。 |
|
次の手順は '_http_proxy/https_proxy_environment 変数を設定するために必要なアクションの概要を示しています一部のプロキシ環境では '_no_proxy 環境変数も設定する必要があります |
プロキシの背後にあるシステムの場合、 Telegraf エージェントをインストールする前に、現在のユーザー * の http_proxy 変数および / または _http_proxy_environment 変数を設定するには、次の手順を実行します。
export https_proxy=<proxy_server>:<proxy_port> * Tegraf エージェントをインストールした後、次のアドレスに appropriate _https_proxy_ および / または _http_proxy_variable を追加して設定します。 _ アプリケーション /Telegraf .app/Contents/telegraf.plist_:
… <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>EnvironmentVariables</key> <dict> <key>https_proxy</key> <string><proxy_server>:<proxy_port></string> </dict> <key>Program</key> <string>/Applications/telegraf.app/Contents/MacOS/telegraf</string> <key>Label</key> <string>telegraf</string> <key>ProgramArguments</key> <array> <string>/Applications/telegraf.app/Contents/MacOS/telegraf</string> <string>--config</string> <string>/usr/local/etc/telegraf.conf</string> <string>--config-directory</string> <string>/usr/local/etc/telegraf.d</string> </array> <key>RunAtLoad</key> <true/> </dict> </plist> …
次に、上記の変更を読み込んだ後、 Tegraf を再起動します。
sudo launchctl stop telegraf sudo launchctl unload -w /Library/LaunchDaemons/telegraf.plist sudo launchctl load -w /Library/LaunchDaemons/telegraf.plist sudo launchctl start telegraf
エージェントをインストールしています
-
エージェントアクセスキーを選択します。
-
エージェントのインストールダイアログからコマンドブロックをコピーします。クリップボードアイコンをクリックすると、コマンドをクリップボードに簡単にコピーできます。
-
Bash ウィンドウを開きます
-
Bash ウィンドウにコマンドを貼り付けて、 Enter キーを押します。
-
コマンドは、適切なエージェントインストーラをダウンロードしてインストールし、デフォルト設定を行います。終了すると、エージェントサービスが再起動されます。コマンドには一意のキーがあり、 24 時間有効です。
-
前に Home醸造 を使用して Tegraf エージェントをインストールしていた場合は、アンインストールするように求められます。以前にインストールした Tegraf エージェントをアンインストールしたら、上記の手順 5 でコマンドを再実行します。
-
[ 完了 ] または [ 続行 ] をクリックします
エージェントのインストール後、次のコマンドを使用してサービスを開始または停止できます。
sudo launchctl start telegraf sudo launchctl stop telegraf
エージェントをアンインストールしています
macOS でエージェントをアンインストールするには、 Bash 端末で次のコマンドを実行します。
-
Telegraf サービスを停止します。
sudo launchctl stop telegraf . テレグラムエージェントをアンインストールします。
sudo cp /Applications/telegraf.app/scripts/uninstall /tmp sudo /tmp/uninstall
-
残っている設定ファイルまたはログファイルを削除します。
sudo rm -rf /usr/local/etc/telegraf* sudo rm -rf /usr/local/var/log/telegraf.*
Agent をアップグレードしています
テレグラムエージェントをアップグレードするには、次の手順に従います。
-
テレグラムサービスを停止します。
sudo launchctl stop telegraf . 前のテレグラムエージェントをアンインストールします。
sudo cp /Applications/telegraf.app/scripts/uninstall /tmp sudo /tmp/uninstall
{empty}{empty}{empty}{empty}{empty}} {empty}
Kubernetes
NetApp Kubernetes Monitoring Operator(NKMO)は、Cloud Insights Insights用のKubernetesをインストールする方法として推奨されます。より柔軟な設定で監視を実行し、Kubernetesクラスタ内で実行される他のソフトウェアを監視する機会を増やします。
お願いします "* ここに移動 *" NetApp Kubernetes Monitoring Operatorに関する情報とインストール手順については、以下を参照してください。
{empty}{empty}{empty}{empty}{empty}} {empty}
チェックサムを検証する
Cloud Insights エージェントのインストーラで整合性チェックが実行されますが、ダウンロードしたアーティファクトのインストールまたは適用前に独自の検証を実行したいユーザもいます。これを行うには、インストーラをダウンロードしてダウンロードしたパッケージのチェックサムを生成し、チェックサムをインストール手順に示されている値と比較します。
インストールせずにインストーラパッケージをダウンロードします
デフォルトのダウンロードおよびインストールではなく、ダウンロードのみの操作を実行するには、UIから取得したエージェントインストールコマンドを編集し、末尾の「インストール」オプションを削除します。
次の手順を実行します。
-
指示に従ってエージェントインストーラスニペットをコピーします。
-
スニペットをコマンドウィンドウに貼り付ける代わりに、テキストエディタに貼り付けます。
-
コマンドから末尾の「 --install 」( Linux/Mac )または「 -install 」( Windows )を削除します。
-
コマンド全体をテキストエディタからコピーします。
-
次に、コマンドウィンドウ(作業ディレクトリ内)に貼り付けて実行します。
Windows 以外( Kubernetes の場合は次の例を使用します。実際のスクリプト名は異なる場合があります)
-
Download and install (デフォルト):
installerName=cloudinsights-kubernetes.sh … && sudo -E -H ./$installerName --download –-install * ダウンロードのみ:
installerName=cloudinsights-kubernetes.sh … && sudo -E -H ./$installerName --download
Windows の場合
-
Download and install (デフォルト):
!$($installerName=".\cloudinsights-windows.ps1") … -and $(&$installerName -download -install) * ダウンロードのみ:
!$($installerName=".\cloudinsights-windows.ps1") … -and $(&$installerName -download)
download-only コマンドを使用すると、必要なアーティファクトがすべて Cloud Insights から作業ディレクトリにダウンロードされます。アーティファクトには次のものがありますが、これらに限定することはできません。
-
インストールスクリプト
-
環境ファイル
-
YAML ファイル
-
署名済みチェックサムファイル(SHA256署名またはSHA256 .ps1で終わる)
-
署名の検証に使用する PEM ファイル( NetApp_cert.pem )
インストールスクリプト、環境ファイル、 YAML ファイルは、目視検査を使用して検証できます。
PEM ファイルは、フィンガープリントが次のようになっていることを確認することで検証できます。
1A918038E8E127BB5C87A202DF173B97A05B4996 具体的には、
-
Windows 以外:
openssl x509 -fingerprint -sha1 -noout -inform pem -in netapp_cert.pem * Windows の場合
Import-Certificate -Filepath .\netapp_cert.pem -CertStoreLocation Cert:\CurrentUser\Root
チェックサム値を生成します
チェックサム値を生成するには、使用するプラットフォームに応じて次のコマンドを実行します。
-
RHEL / Ubuntu:
sha256sum <package_name> * MacOS:
shasum -a 256 telegraf.pkg * Windows の場合
Get-FileHash telegraf.zip -Algorithm SHA256 | Format-List
PEMファイルを使用してチェックサムを確認してください
署名済みチェックサムファイルは、 PEM ファイルを使用して確認できます。
-
Windows 以外:
openssl smime -verify -in telegraf*.sha256.signed -CAfile netapp_cert.pem -purpose any * Windows (上記の「証明書のインポート」を使用して証明書をインストールした後):
Get-AuthenticodeSignature -FilePath .\telegraf.zip.sha256.ps1 $result = Get-AuthenticodeSignature -FilePath .\telegraf.zip.sha256.ps1 $signer = $result.SignerCertificate Add-Type -Assembly System.Security [Security.Cryptography.x509Certificates.X509Certificate2UI]::DisplayCertificate($signer)
ダウンロードしたパッケージをインストールします
すべてのアーティファクトが正常に検証されたら、次のコマンドを実行してエージェントのインストールを開始できます。
Windows 以外:
sudo -E -H ./<installation_script_name> --install Windows の場合
.\cloudinsights-windows.ps1 -install
トラブルシューティング
エージェントの設定で問題が発生した場合の対処方法を次に示します。
問題 | 次の操作を実行します |
---|---|
新しいプラグインを設定してTegrafを再起動すると、Tegrafが起動しない。ログには、次のようなエラーが表示されます。"[テレ グラム]エージェント実行エラー:設定ファイルのロード中にエラーが発生しました。/etc/exraf/exraf.d/cusinetrainesetraine-default.conf:プラグイン出力。http:line <linenumber> :configuration specified the fields [use_system_proxy"]、but they were not used] |
インストールされているTelegrafのバージョンが古い。このページの手順に従って、お使いのプラットフォームに対応するエージェント*をアップグレードしてください。 |
古いインストールでインストーラスクリプトを実行したが、エージェントがデータを送信していない |
テレグラムエージェントをアンインストールし、インストールスクリプトを再実行します。お使いのプラットフォームに応じて、このページの*エージェントのアップグレード*の手順を実行します。 |
すでに Cloud Insights を使用してエージェントをインストールしました |
ホスト /VM にエージェントがすでにインストールされている場合は、エージェントを再度インストールする必要はありません。この場合は、 Agent Installation (エージェントのインストール)画面で適切な Platform and Key (プラットフォームとキー)を選択し、 * Continue * (続行)または * Finish (完了) * をクリックします。 |
すでにエージェントをインストールしていますが、 Cloud Insights インストーラを使用してインストールしていません |
前のエージェントを削除し、 Cloud Insights エージェントのインストールを実行して、適切なデフォルト設定ファイルを設定します。完了したら、 [* Continue * (続行) ] または [* Finish (完了) ] をクリックします。 |
追加情報はから入手できます "サポート" ページまたはを参照してください "Data Collector サポートマトリックス"。