FluentD 出力プラグインガイド
Revision: 1.1.0-426
1 Fluentd用プラグインfluent-plugin-griddb
fluent-plugin-griddbはhttpを使用してGridDBにデータを挿入するためのFluent出力プラグインです。
1.1 インストール
1.1.1 システム要件
- Ruby バージョン 2.7.2
- Fluentd バージョン 1.12.0
1.1.2 fluentdのインストール
以下を参照し、fluentをセットアップし、インストールします。 https://docs.fluentd.org/installation/install-by-gem
1.1.3 ローカルソースコードからプラグインインストール
fluent-plugin-griddbプラグインをダウンロードします。
$ cd fluent-plugin-griddb
$ gem build fluent-plugin-griddb.gemspec
$ gem install --force --local fluent-plugin-griddb-1.0.0.gem
1.2 使用方法
1.2.1 入力プラグイン
1.2.1.1 Apacheログ
パラメータ | 値 |
---|---|
@type | tail (必須) |
path | 読み込むログファイルのパス (必須) |
pos_file | Fluentdはこのファイルから前回読み込んだ場所を記録します。 |
tag | イベントのタグ (必須) |
parse | ログの形式 (必須) |
例
<source>
@type tail
path /var/log/httpd-access.log
pos_file /var/log/td-agent/httpd-access.log.pos
tag apache.access
<parse>
@type apache2
</parse>
</source>
注意: 詳細は https://docs.fluentd.org/input/tail を参照。
1.2.1.2 システムログ
パラメータ | 値 |
---|---|
@type | syslog (必須) |
port | リッスンするポート |
bind | リッスンするバインドアドレス |
parse | ログの形式 (必須) |
tag | タグのプレフィックス |
例
<source>
@type syslog
port 5140
bind 0.0.0.0
<parse>
@type syslog
</parse>
tag system
</source>
注意: 詳細は https://docs.fluentd.org/input/syslog を参照。
1.2.2 フィルタプラグイン (任意)
<filter></filter>
注意: 詳細は https://docs.fluentd.org/filter を参照。
1.2.3 出力プラグイン
1.2.3.1 パラメータ
パラメータ | 値 |
---|---|
@type | griddb(必須) |
host | GridDB WebAPIのURL(必須) |
cluster | クラスタ名(必須) |
database | 値がnullまたは空の場合、publicがデフォルトになります。 |
container | コンテナ名(必須) |
insert_mode | appendまたはreplace。値がnullまたは空の場合、appendがデフォルトになります。 |
insert_type | singleまたはmultiple。値がnullまたは空の場合、singleがデフォルトになります。 |
username | ユーザ名 (必須) |
password | パスワード (必須) |
1.2.3.2 例
下記はfluent-plugin-griddbを使用した場合の詳細例です。
<match griddb>
@type griddb
host http://localhost:8080/
cluster defaultCluster
database public
container container_1
insert_mode append
insert_type single
username admin
password admin
</match>