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

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

Fluent Bit ログを New Relic に転送すると、ログデータの収集、処理、探索、クエリ、アラートを行うための強化された機能が提供されます。

基本的なプロセス

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

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

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

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

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

GitHub 上の New Relic の Fluent Bit プラグインリポジトリに移動します。 2. リポジトリページから、リポジトリを複製またはダウンロードします。 3. 次のコマンドを実行してプラグインをビルドします。
bash
```
$cd newrelic-fluent-bit-output && make all
```
fluent-bitデーモンがアクセスできる場所にout_newrelic.soまたはout_newrelic_winXX.dllを格納します。

ヒント

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

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

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

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

注意

Fluent Bit 出力プラグインのバージョン 1.16.0 から 1.19.2 は、セキュリティ脆弱性 (CVE-2024-4323)の影響を受けます。これらのバージョンのいずれかを使用している場合は、バージョン 2.0.0 以上にアップグレードしてください。詳細については、セキュリティ速報 NR24-01 - Fluent Bitを参照してください。

アップグレードするには、インストールの手順に従うか、 GitHub リポジトリから最新のコンパイル済みバージョンを入手してください。

Fluent Bit出力プラグインをインストールする

New Relic には、ログを New Relic ログ管理に転送するためのFluent Bit 出力プラグインがあります。このプラグインは、docker KubernetesKubernetesプラグインとも呼ばれる DaemonSet の形式でクラスタにインストールできるスタンドアロンのイメージでも提供されます。

Helm チャートを使用して、2 つの方法でクラスターにインストールできます。

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

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

これをインストールする最良の方法は、ガイド付きのインストレーションプロセスを実行することです。このガイド付きインストールでは、インストールに必要な Helm 3 コマンドを生成できます ( 「Helm 3」を参照)。

手動インストール

あるいは、次のコマンドを実行してリポジトリをインストールし、Helm を使用して手動でインストールすることもできます。

bash

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

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

bash

$helm repo update newrelic

アンインストール手順については、こちらをご覧ください。

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

Fluent Bit は、New Relic にデータを出力するために、New Relic プラグインと New Relic の場所を知る必要があります。 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ファイルの最後に次の行を追加して、入力、フィルター、出力セクションを設定します。プレースホルダーテキストをに置き換えます。

[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

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

このドキュメントはインストールの役に立ちましたか？

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

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

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

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

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

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

鍵	説明
`licenseKey`	。 `licenseKey` ( recommended ) または`apiKey`いずれかを使用し、両方を使用することはできません。デフォルト： `none`
`maxBufferSize`	ペイロードが送信する最大サイズ（バイト単位）。デフォルト： `256000`
`maxRecords`	一度に送信するレコードの最大数。デフォルト： `1024`
`apiKey`	Deprecated. New Relicinサイトの挿入キーを受け取りますが、 `licenseKey`属性を使用することをお勧めします。 `licenseKey`または`apiKey`の両方ではなく、いずれかを使用します。
`endpoint`	デフォルトは`https://log-api.newrelic.com/log/v1`です - EUキーを使用する場合は設定する必要があります `https://log-api.eu.newrelic.com/log/v1`

ログデータを表示する

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

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

SELECT * FROM Log

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

次は何ですか？

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

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

ログ転送を無効にする

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

この機械翻訳は、参考として提供されています。