6. ログの受信設定をするには(Input設定)

6.3.1. GELFとは

GELFは、Graylog Extended Log Formatの省略形です。 このログフォーマットは、JSONを拡張したGraylog独自のログフォーマットです。 Syslogなどに代表される従来のログは、ログの情報が構造化されていませんでした。 GELFは、ログを構造化して送信することで、検索や可視化などで利用しやすい形で保存しておくことを目的としてます。

GELFフォーマットの例:

{
"version": "1.1",
"host": "example.org",
"short_message": "A short message that helps you identify what is going on",
"full_message": "Backtrace here\n\nmore stuff",
"timestamp": 1385053862.3072,
"level": 1,
"_user_id": 9001,
"_some_info": "foo",
"_some_env_var": "bar"
}

GELFフォーマットの詳細はGELFの章を参照してください。

6.3.2. GELF HTTPの設定

GELF HTTPを選択し、Launch new input をクリックすると以下の画面が表示されます。

それぞれの項目の意味は以下の通りです。

• Global
  • チェックすると、全てのGraylogノードでこのinput設定を有効化する
• Node
  • このinput設定を有効にするGraylogノードを選択する
• Title
  • このinput設定の名前の入力フォーム
• Bind address
  • GELF HTTPサーバがリッスンするIPアドレス
• Port
  • GELF HTTPサーバがリッスンするポート
• Receive Buffer Size(optional)
  • ネットワークの受信バッファサイズを指定する

• No. of worker threads(optional)
  • ネットワーク接続を処理するスレッド数を指定する
• TLS cert file(optional)
  • TLS証明書ファイルのパスを指定する
• TLS private key file(optional)
  • TLSプライベート鍵ファイルのパスを指定する
• Enable TLS(optional)
  • チェックした場合、TLS接続を有効化する
• TLS key password(optional)
  • TLS鍵のパスフレーズを指定する
• TLS client authentication (optional)
  • クライアント認証ポリシーを設定する
  • disable/optional/requiredから選択する
    • disable: CA証明書の検証を行わない
    • optional: CA証明書があれば検証する
    • required: 必ずCA証明書の検証を行なう
• TLS client Auth Trusted Certs (optional)
  • クライアント認証に利用する証明書のパス設定する
  • ファイルまたはディレクトリを指定する
• TCP keepalive (optional)
  • チェックするとTCPキープアライブが有効になる
• Enable CORS(optional)
  • チェックするとCORS関連の機能が有効になる
• Max. HTTP chunk size(optional)
  • HTTPチャンクサイズの最大値を指定する
  • 単位はbyteです
• Idle writer timeout
  • クライアントの書き込みリクエストのタイムアウト時間を指定する
  • 単位は秒です
• Override source(optional)
  • sourceフィールドを強制的に上書きする値を設定するフォーム
  • 通常sourceフィールドには、ログの送信元が記録される
• Decompressed size limit(optional)
  • 圧縮されたデータを展開した後に許容する最大サイズ
  • 単位はbyteです

設定を行ない save すると、新しいInputの情報が登録されます。

この設定で、GraylogはHTTPプロトコルでGELFメッセージを受け取ることができます。 確認はcurlなどのコマンドで行なうことができます。