本文へジャンプ

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>