telegraf エージェントが一部のアプリケーション サービスのメトリックを収集するためには、エンドポイントの仮想マシンで変更を行う必要があります。これらの変更を行った後に、エージェントはメトリックの収集を開始します。エージェントをデプロイした、構成ファイルを変更する仮想マシンに SSH で接続する必要があります。
Apache HTTPD
/etc/httpd/conf.modules.d/status.conf にある conf ファイルを変更し、エージェントがメトリックを収集するように HTTPD の mod_status プラグインを有効にします。
<IfModule mod_status.c> <Location /server-status> SetHandler server-status </Location> ExtendedStatus On </IfModule>conf ファイルがない場合は、ファイルを作成する必要があります。次のコマンドで conf ファイルを変更した後に HTTPD サービスを再起動します。
systemctl restart httpd
Java プラグイン
Java アプリケーションを監視するには、Jolokia プラグインを .WAR ファイルまたは .JAR ファイルとしてデプロイします。.WAR ファイルをデプロイする場合は、サービスを再起動する必要はありません。
.JAR ファイルをデプロイする場合は、監視対象の JAVA プロセスの JMX 引数に JAR の完全なファイル パスを含めた後にアプリケーション サービスを再起動する必要があります。
Nginx
/etc/nginx/nginx.conf にある conf ファイルに次の行を追加します。
http { server { location /status { stub_status on; access_log off; allow all; } } }
次のコマンドで Nginx サービスを再起動します。
systemctl restart nginx
Postgres
/var/lib/pgsql/data/pg_hba.conf にある構成ファイルで
local all postgres peer
の値を
local all postgres md5
に変更し、次のコマンドでサービスを再起動します。
sudo service postgresql restart
Cassandra データベース
Cassandra データベース アプリケーションを監視するには、Cassandra データベース アプリケーションへの JVM 入力としてデータを格納する必要があります。次の手順を実行します。
- /etc/default/cassandra を変更します。
echo "export JVM_EXTRA_OPTS=\"-javaagent:/usr/share/java/jolokia-jvm-1.6.0-agent.jar=port=8778,host=localhost\"" | sudo tee -a /etc/default/cassandra
- または、cassandra-env.sh を変更して、エージェントを有効にすることもできます。cassandra-env.sh の末尾に次の行を追加します。
JVM_OPTS="$JVM_OPTS -javaagent:/usr/share/java/jolokia-jvm-1.6.0-agent.jar=port=8778,host=localhost"
JVM 入力が表示されたら、Cassandra サービスを再起動します。
Oracle データベース
Oracle データベースを監視するには、次の手順を実行します。
- https://www.oracle.com/database/technologies/instant-client/downloads.html からインスタント クライアント ライブラリをダウンロードします。
Oracle インスタント ライブラリをダウンロードし、PATH に含める必要があります。
- ユーザーを作成します。
CREATE USER <UserName> IDENTIFIED BY <yourpassword>; GRANT select_catalog_role TO <UserName>; GRANT CREATE SESSION TO <UserName>;
- Python 3.6 以降をインストールします。
python3 -m pip install cx_Oracle --upgrade
- TNS_ADMIN の PATH を設定します。
たとえば、TNS_ADMIN のパスは c:\app\product\<version>\dbhome_1\NETWORK\ADMIN” のような形となります。
注: Oracle データベースは Linux プラットフォームで有効にすることはできません。
Active MQ 5.16 以降のバージョン
Active MQ 5.16 以降のバージョンを有効にするには、次の手順を実行します。
- /opt/activemq/apache-activemq-5.16.0/webapps/api/WEB-INF/classes/jolokia-access.xml に移動します。
- 次の行を削除するか、コメント アウトします:
<cors> <strict-checking/> </cors>
- Active MQ サービスを再起動します。
MS SQL
ユーザー アカウントには、Telegraf で MS SQL アプリケーションを監視するために次の権限が必要です。
USE master; GO CREATE LOGIN [telegraf] WITH PASSWORD = N'mystrongpassword'; GO GRANT VIEW SERVER STATE TO [telegraf]; GO GRANT VIEW ANY DEFINITION TO [telegraf]; GO