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

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

Fluent Bit ログをNew Relicに転送すると、ログ データの収集、処理、探索、書き込み、集計の機能が強化されます。ログ管理 Fluent Bit をインストールするには、次のオプションがあります。

• Kubernetesへのインストレーション
• Dockerイメージの使用
• オンホストのインストール

Kubernetesへのインストレーション

New Relic には、ログを New Relic ログ管理に転送するためのFluent Bit 出力プラグインがあります。 このプラグインは、スタンドアロンの Docker イメージとしてKubernetesクラスタにインストールできます。このプラグインは、 Kubernetesプラグインとも呼ばれる DaemonSet として機能します。

Helm チャートを使用してクラスターにインストールするには、次の 2 つの方法があります。

• ガイド付きインストールを通じて
• 手動インストール

ガイド付きインストールを使用する

newrelic-loggingチャートはスタンドアロンとしても機能しますが、 nri-bundleチャートの一部としてインストールすることをお勧めします。

これをインストールする最良の方法は、ガイド付きのインストールプロセスを使用することです。 このガイド付きインストールでは、インストールに必要な Helm コマンドが生成されます。

手動インストール

Helm を使用して手動でインストールすることもできますが、このオプションは推奨されません。 リポジトリをインストールするには、次のコマンドを実行します。

$
helm repo add newrelic https://helm-charts.newrelic.com

リポジトリを更新するには、次のコマンドを実行します。

$
helm repo update newrelic

アンインストールする場合は、 Kubernetesインテグレーションのアンインストール」を参照してください。

Dockerイメージの使用

Kubernetes独自のカスタム インテグレーションをお持ちの場合は、 プラグインに付属の Docker イメージ newrelic-fluent-bit-outputを使用することをお勧めします。または、Docker イメージをベースイメージとして使用し、独自のカスタム設定ファイルをレイヤー化することもできます。

オンホストのインストール

Fluent Bit プラグインをホスト上でインストールするには、次の手順に従います。

1. GitHub で New Relic のFluent Bit プラグイン リポジトリを開きます。

2. リポジトリ ページから、 リポジトリをクローンまたはダウンロードします。

3. プラグインをビルドするには、次のコマンドを実行します。

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

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

Fluent Bit プラグインをアップグレードする

Fluent Bit プラグインをアップグレードする前に、次の NRQL クエリを実行して、システムで使用している出力プラグインの現在のバージョンを見つけます。

FROM K8sContainerSample 
SELECT latest(containerImage) 
WHERE podName like '%newrelic-logging%' 
FACET clusterName

更新するには、インストレーションの指示に従うか、 GitHub リポジトリから最新のコンパイル済みバージョンを取得します。

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

Fluent Bit は、New Relic にデータを出力するために、New Relic プラグインと New Relic ライセンスキーの場所を認識する必要があります。

Fluent Bit プラグインを構成するには、次の手順に従います。

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

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

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

3. 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

4. fluent-bit.confファイルの最後に次の行を追加して、入力、フィルター、出力セクションを設定します。 プレースホルダー テキストをライセンスキーに置き換えます。

   [INPUT]
       Name tail
       Tag  my.tag
       Path /PATH/TO/YOUR/LOG/FILE
       
   # If you have multiple sources, just add another [INPUT] section like this:
   [INPUT] 
       Name tail 
       Tag  my.other.tag 
       Path /PATH/TO/SOME/OTHER/LOG/FILE 
   
   # Having multiple [FILTER] blocks allows you to control the flow of changes as they read top down. 
   [FILTER]
       Name modify
       # Here we only match on one tag, my.tag, defined in the [INPUT] section earlier
       Match  my.tag
       # Below, we're renaming the host.cpu attribute to CPU
       Rename host.cpu CPU
   
   [FILTER]
       Name   record_modifier
       # Match on all tags, *, so all logs get decorated per the Record clauses below. Record adds attributes + their values to each record.
       Match  *
       # Adding a logtype attribute ensures your logs will be automatically parsed by our built-in parsing rules
       Record logtype nginx
       # Add the server's hostname to all logs generated
       Record hostname ${HOSTNAME}
   
   [OUTPUT]
       Name       newrelic
       Match      *
       licenseKey YOUR_LICENSE_KEY

   コピー

5. Fluent Bit インスタンスを再起動します。 次のコマンドを実行します:

   bash

   コピー

   $
   fluent-bit -c /PATH/TO/fluent-bit.conf

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

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

1. 次のコマンドを実行して、テスト ログメッセージをログファイルに追加します。

   bash

   コピー

   $
   echo "test message" >> /PATH/TO/YOUR/LOG/FILE

2. ログ UIでtest messageを検索します。

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

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

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

ログデータを表示する

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

• ログUI

• NRQL クエリを実行するためのツール。 たとえば、次のようなクエリを実行できます。

SELECT * 
FROM Log

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

次は何ですか？

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

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

• アラートを設定します。

• データをクエリし、ダッシュボードを作成します。

ログ転送を無効にする

ログ転送機能を無効にするには、 Fluent Bit ドキュメントの標準手順に従ってください。 New Relic では他に何もする必要はありません。