テレグラフ

Telegraf は、メトリックの収集、処理、集計、および書き込みを行うためのエージェントです。に基づいて コミュニティの開発者が追加のサポートを簡単に追加できるようにするプラグインシステム メトリック収集。プラグインには4つの異なるタイプがあります。

1. 入力プラグインは、システム、サービス、またはサードパーティのAPIからメトリックを収集します
2. プロセッサプラグインは、メトリックを変換、装飾、および/またはフィルタリングします
3. アグリゲータープラグインは、集計メトリック(平均、最小、最大、分位数など)を作成します。
4. 出力プラグインは、さまざまな宛先にメトリックを書き込みます

新しいプラグインは簡単に貢献できるように設計されており、プルリクエストは歓迎され、私たちは できるだけ多くのプル要求を組み込みます。外部プラグインのリストも見ることを検討してください。

最小動作環境

TelegrafはGoと同じ最小要件を共有しています。

• Linux カーネルバージョン 2.6.23 以降
• ウィンドウズ 7 以降
• FreeBSD 11.2 以降
• MacOS 10.11 エルキャピタン以降

テレグラフの取得

バージョンごとの最新の更新と変更の変更ログを表示します。

バイナリダウンロード

バイナリのダウンロードは、InfluxData のダウンロードページまたは各 GitHub リリースページから入手できます。

パッケージリポジトリ

InfluxData は、DEB と RPM の両方のダウンロードを含むパッケージ リポジトリも提供します。

debベースのプラットフォーム(UbuntuやDebianなど)の場合は、次のコマンドを実行して リポジトリキーと新しいソース.listエントリを設定します。

# influxdb.key GPG Fingerprint: 05CE15085FC09D18E99EFB22684A14CF2582E0C5
wget -q https://repos.influxdata.com/influxdb.key
echo '23a1c8836f0afc5ed24e0486339d7cc8f6790b83886c4c96995b88a061c5bb5d influxdb.key' | sha256sum -c && cat influxdb.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/influxdb.gpg > /dev/null
echo 'deb [signed-by=/etc/apt/trusted.gpg.d/influxdb.gpg] https://repos.influxdata.com/debian stable main' | sudo tee /etc/apt/sources.list.d/influxdata.list
sudo apt-get update && sudo apt-get install telegraf

RPMベースのプラットフォーム(RHEL、CentOSなど)の場合は、次のコマンドを使用してリポジトリを作成します テレグラフのファイルおよびインストール:

# influxdb.key GPG Fingerprint: 05CE15085FC09D18E99EFB22684A14CF2582E0C5
cat <<EOF | sudo tee /etc/yum.repos.d/influxdata.repo
[influxdata]
name = InfluxData Repository - Stable
baseurl = https://repos.influxdata.com/stable/\$basearch/main
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdb.key
EOF
sudo yum install telegraf

ソースからビルド

Telegraf には Go バージョン 1.18 以降が必要で、Makefile には GNU make が必要です。

Windows では、メイクファイルでは、すべてのメイクファイル ターゲットをサポートするために bash ターミナルを使用する必要があります。 ウィンドウ用のbashを取得する簡単なオプションは、ウィンドウ用のgitに付属しているバージョンを使用することです。

1. Go のインストール >=1.18 (1.18.0 を推奨)

2. Telegrafリポジトリのクローンを作成します。

   git clone https://github.com/influxdata/telegraf.git

3. ソースディレクトリから実行する

   make build

   cd telegraf
   make build

ナイトリービルド

マスターブランチから生成されたナイトリービルドが利用可能です。

3rdパーティビルド

他のプラットフォームまたはパッケージ形式のビルドは、Telegrafコミュニティのメンバーによって提供されます。 これらのパッケージは、Telegraf プロジェクトまたは InfluxData によってビルド、テスト、またはサポートされていません。お願いします サポートが必要な場合は、パッケージの作成者に連絡してください。

• アンシブルロール
• チョコレート バイ リップクローフ
• スクープ
• ローラン・セスケスによるスナップ(サジューパ)
• 自作

はじめ

使用法を参照してください。

telegraf --help

テレグラフ構成ファイルを生成する

telegraf config > telegraf.conf

CPU入力とinfluxdb出力プラグインのみが定義された構成を生成する

telegraf config --section-filter agent:inputs:outputs --input-filter cpu --output-filter influxdb

単一のテレグラフコレクションを実行し、メトリックを標準出力に出力する

telegraf --config telegraf.conf --test

設定ファイルで定義されたすべてのプラグインでtelegrafを実行します

telegraf --config telegraf.conf

telegraf を実行し、CPU とメモリ入力を有効にし、influxdb 出力プラグインを有効にします。

telegraf --config telegraf.conf --input-filter cpu:mem --output-filter influxdb

プロジェクトへの貢献

TelegrafはMITライセンスのオープンソースプロジェクトであり、私たちはコミュニティを愛しています。何かを修正する最も速い方法は、PRを開くことです。 あなたが助けることに興味があるなら、私たちの貢献ガイドをチェックしてください。また、エンジニアリングチームに質問やコメントがある場合は、コミュニティSlackまたはコミュニティページに参加してください。

TelegrafとInfluxDBにまったく慣れていない場合は、InfluxDB大学に無料で登録して、詳細を学ぶためのコースを受講することもできます。

ドキュメンテーション

最新リリースのドキュメント

最新の開発コードに関するドキュメントについては、ドキュメント インデックスを参照してください。

• 入力プラグイン
• 出力プラグイン
• プロセッサプラグイン
• アグリゲータープラグイン