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 入力としてデータを格納する必要があります。次の手順を実行します。
  1. /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
  2. または、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 データベースを監視するには、次の手順を実行します。
  1. https://www.oracle.com/database/technologies/instant-client/downloads.html からインスタント クライアント ライブラリをダウンロードします。

    Oracle インスタント ライブラリをダウンロードし、PATH に含める必要があります。

  2. ユーザーを作成します。
    CREATE USER <UserName> IDENTIFIED BY <yourpassword>;
     GRANT select_catalog_role TO <UserName>;
     GRANT CREATE SESSION TO <UserName>;
  3. Python 3.6 以降をインストールします。
    python3 -m pip install cx_Oracle --upgrade
  4. 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