Elasticsearch:Logstash構成ファイル

Logstashパイプライン構成ファイルを使用すると、各タイプのプラグインを個別の部分で構成できます。

input {
  // ... 入力設定
}

filter {
  // ... フィルター設定
}

output {
  // ... 出力設定
}

プラグインの構成は、プラグイン名とプラグインプロパティの集合で構成されます。 次の構成では、入力部分で2つのbeatsプラグインが定義されており、各プラグインには port プロパティと host プロパティが含まれています。

input {
  beats {
    port => 8000 // ポート番号
    host => "118.11.xx.xx" // ホストアドレス
  }

  beats {
    port => 8001 // ポート番号
    host => "192.168.xx.xx" // ホストアドレス
  }
}

この型は推奨されません。 文字列などの標準型を使用することをお勧めします。 型チェックを容易にするために、:list => true プロパティを定義できます。 この型は、型チェックを必要としないハッシュテーブルまたは混合型のリストを処理する場合に使用します。 例：

users => [ {id => 1, name => bob}, {id => 2, name => jane} ] // ユーザーリスト

リスト自体は型ではありませんが、その属性は型の特性を備えています。 型チェックのために複数の値を入力できます。 パラメーターを宣言するときに :list => true を指定すると、プラグインはリストチェックを有効にします。 例：

path => [ "/var/log/messages", "/var/log/*.log" ] // パスリスト
uris => [ "http://elastic.co", "http://example.net" ] // URIリスト

ブール型の値は、true または false である必要があります。 値は引用符で囲まないでください。 例：

ssl_enable => true // SSL有効化

バイト型のフィールドは、有効なバイト数を表す文字列フィールドです。 これは、プラグインオプションで特定のサイズを宣言する便利な方法です。 バイト型は、10進数（k M G T P E Z Y）と2進数（Ki Mi Gi Ti Pi Ei Zi Yi）をサポートしています。 10進数の単位は基数1000で、2進数の単位は基数1024です。 フィールドは大文字と小文字を区別せず、値と単位の間にスペースを入れることができます。 単位が指定されていない場合、整数文字列はバイト数を示します。 例：

 my_bytes => "1113"   // 1113 バイト
 my_bytes => "10MiB"  // 10485760 バイト
 my_bytes => "100kib" // 102400 バイト
 my_bytes => "180 mb" // 180000000 バイト

使用可能なコーデックの詳細については、「コーデックプラグイン」をご参照ください。 例：

codec => "json" // JSONコーデック

例：

match => {
  "field1" => "value1" // フィールド1の値
  "field2" => "value2" // フィールド2の値
  // ...
}
// キーと値のペアを1行で指定します。 キーと値のペアは、コンマ（,）ではなくスペースで区切ります。
match => { "field1" => "value1" "field2" => "value2" } // 1行での指定

数値型の値は、浮動小数点数または整数である必要があります。 例：

port => 33 // ポート番号

パスワードは、記録または表示されない単一値の文字列です。 例：

my_password => "password" // パスワード

URIは、完全なURLからfoobarなどの単純な識別子まで多岐にわたります。 URIに http://user:paas@example.net などのパスワードが含まれている場合、パスワードは記録または表示されません。 例：

 my_uri => "http://foo:bar@example.net" // URI

パスは、オペレーティングシステムの有効なパスを表す文字列です。 例：

my_path => "/tmp/logstash" // パス

デフォルトでは、Logstashはエスケープシーケンスを有効にしていません。 引用符で囲まれた文字列でエスケープシーケンスを使用する場合は、config.support_escapes: true // エスケープシーケンスをサポートするかどうかlogstash.yml に

エスケープ文字	説明	ASCII 値 (10 進数)
\r	キャリッジリターン	013
\n	改行	010
\t	タブ	009
\\	バックスラッシュ	092
\"	二重引用符	034
\'	単一引用符	039

を追加します。 次に、引用符で囲まれた文字列（倍精度と単精度）は、次の表に基づいて変換されます。

例：

name => 'It\'s a beautiful day' // エスケープシーケンスを含む文字列

コメントはシャープ記号（#）で始まり、行の先頭にある必要はありません。 例：

# コメント

input { # コメント
  // ...
}