ログ転送用のFluentBitプラグイン

ログデータがすでにFluentBitによって監視されている場合は、 Fluent Bit出力プラグインを使用して、NewRelicでログデータを転送および強化できます。

FluentBitログをNewRelicに転送すると、ログデータを収集、処理、探索、クエリ、およびアラートするための拡張ログ管理機能が提供されます。

基本的なプロセス

プラグインがインストールされたコンテナを公開しました。これは、Kubernetes統合で使用されるベースイメージとして機能します。このベースイメージを使用して、独自のカスタム構成ファイルをレイヤー化することをお勧めします。

FluentBitからNewRelicにログを転送するには：

あなたが持っていることを確認してください：
- NewRelicライセンスキー
- Fluent Bit 1.0以降（推奨）、ただしv0.12以降はサポートされています
- FluentBitWindowsのインストール手順はここにあります
- FluentBitLinuxのインストール手順はここにあります
FluentBitプラグインをインストールします。
FluentBitプラグインを構成します。
FluentBitプラグインをテストします。
トラフィックを生成して数分待ってから、アカウントのデータを確認してください。

FluentBitプラグインをインストールします

Fluent Bitプラグインをインストールするには：

GitHubでNewRelicのFluentBitプラグインリポジトリに移動します。
リポジトリページから、リポジトリのクローンを作成するか、ダウンロードします。
次のコマンドを実行して、プラグインをビルドします。

cd newrelic-fluent-bit-output && make all

fluent-bitデーモンがアクセスできる場所にout_newrelic.soまたはout_newrelic_winXX.dllを格納します。

ヒント

プラグインを自分でコンパイルしたくない場合は、 GitHubリポジトリのリリースページからコンパイル済みのバージョンをダウンロードできます。

FluentBitプラグインを構成します

Fluent Bitは、NewRelicにデータを出力するためにNewRelicプラグインとNewRelicライセンスキーの場所を知る必要があります。Fluent Bitプラグインを構成するには：

重要

設定ファイルを編集するときは、空白に注意してください。インデントには必ず4つのスペースを使用し、キーと値の間には1つのスペースを使用してください。

プラグインディレクトリでplugins.confファイルを見つけるか作成します。

plugins.confファイルで、 fluent-bit.confファイルに隣接するout_newrelic.soへの参照を追加します。

[PLUGINS]
    Path /PATH/TO/newrelic-fluent-bit-output/out_newrelic.so

fluent-bit.confファイルで、 serviceブロックの下に次の行を追加します。

[SERVICE]
# This is the main configuration block for fluent bit.
# Ensure the follow line exists somewhere in the SERVICE block
Plugins_File plugins.conf

fluent-bit.confファイルの下部に以下を追加して、入力フィルターと出力フィルターを設定します。プレースホルダーテキストをNewRelicライセンスキーに置き換えます。
```
[INPUT]
    Name tail
    Path /PATH/TO/YOUR/LOG/FILE

[OUTPUT]
    Name newrelic
    Match *
    licenseKey YOUR_LICENSE_KEY

# Optional
maxBufferSize 256000
maxRecords 1024
```
次のコマンドを使用して、FluentBitインスタンスを再起動します。
```
fluent-bit -c /PATH/TO/fluent-bit.conf
```

FluentBitプラグインをテストする

Fluent Bitプラグインがログファイルから入力を受信しているかどうかをテストするには、次の手順に従います。

次のコマンドを実行して、テストログメッセージをログファイルに追加します。
```
echo "test message" >> /PATH/TO/YOUR/LOG/FILE
```
NewRelicのログUIでtest messageを検索します。

ログをエンティティに関連付ける

ログ行をインフラストラクチャホストなどのエンティティに関連付けるには、 FILTERブロックを追加します。

[FILTER]
  Name modify
  Match * # Or specify a match
  Add entity.guids <Your Entity GUID ID> # Optional
  Add hostname <Your hostname> # Optional

その他のオプションについては、インフラストラクチャエージェントを使用してログを転送するためのFluentBit変更フィルターのドキュメントとドキュメントを参照してください。

オプション：プラグイン属性を構成します

Fluent Bitプラグインをインストールして構成したら、次の属性を使用して、プラグインがNewRelicにデータを送信する方法を構成できます。

鍵	説明
`licenseKey`	NewRelicライセンスキー。`licenseKey` （推奨）または`apiKey`のいずれかを使用します。両方は使用しないでください。デフォルト： `none`
`maxBufferSize`	ペイロードが送信する最大サイズ（バイト単位）。デフォルト： `256000`
`maxRecords`	一度に送信するレコードの最大数。デフォルト： `1024`
`apiKey`	非推奨。New Relic Insightsの挿入キーを使用しますが、 `licenseKey`属性を使用することをお勧めします。両方ではなく、 `licenseKey`または`apiKey`のいずれかを使用してください。

ログデータを表示する

すべてが正しく構成され、データが収集されている場合は、次の両方の場所にデータログが表示されます。

NewRelicのログUI
NRQLクエリを実行するための新しいRelicツール。たとえば、次のようなクエリを実行できます。

SELECT * FROM Log

ログ管理機能を有効にしてもデータが表示されない場合は、標準のログトラブルシューティング手順に従ってください。

次は何ですか？

Logs UIを使用して、プラットフォーム全体のログデータを調べます。

ログインコンテキスト機能を使用してログを転送することにより、アプリケーションとプラットフォームのパフォーマンスデータの両方をより深く把握できます。
アラートを設定します。
データをクエリし、ダッシュボードを作成します。

ログ転送を無効にする

ログ転送機能を無効にするには、 FluentBitのドキュメントの標準的な手順に従います。NewRelicでは他に何もする必要はありません。

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。