ログデータがすでに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 blockPlugins_File plugins.conffluent-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にデータを送信する方法を構成できます。
鍵 | 説明 |
---|---|
| NewRelicライセンスキー。 |
| ペイロードが送信する最大サイズ(バイト単位)。デフォルト: |
| 一度に送信するレコードの最大数。デフォルト: |
| 非推奨。New Relic Insightsの挿入キーを使用しますが、 |
ログデータを表示する
すべてが正しく構成され、データが収集されている場合は、次の両方の場所にデータログが表示されます。
- NewRelicのログUI
- NRQLクエリを実行するための新しいRelicツール。たとえば、次のようなクエリを実行できます。
SELECT * FROM Log
ログ管理機能を有効にしてもデータが表示されない場合は、標準のログトラブルシューティング手順に従ってください。
次は何ですか?
Logs UIを使用して、プラットフォーム全体のログデータを調べます。
- ログインコンテキスト機能を使用してログを転送することにより、アプリケーションとプラットフォームのパフォーマンスデータの両方をより深く把握できます。
- アラートを設定します。
- データをクエリし、ダッシュボードを作成します。
ログ転送を無効にする
ログ転送機能を無効にするには、 FluentBitのドキュメントの標準的な手順に従います。NewRelicでは他に何もする必要はありません。