• ログイン

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

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

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

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

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

基本的なプロセス

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

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

  1. あなたが持っていることを確認してください:

    • NewRelicライセンスキー
    • Fluent Bit 1.0以降(推奨)、ただしv0.12以降はサポートされています
    • FluentBitWindowsのインストール手順はここにあります
    • FluentBitLinuxのインストール手順はここにあります
  2. FluentBitプラグインをインストールします。

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

  4. FluentBitプラグインをテストします。

  5. トラフィックを生成して数分待ってから、アカウントのデータを確認してください

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

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

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

ヒント

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

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

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

重要

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

  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ファイルの下部に以下を追加して、入力フィルターと出力フィルターを設定します。プレースホルダーテキストをNewRelicライセンスキーに置き換えます。

    [INPUT]
        Name tail
        Path /PATH/TO/YOUR/LOG/FILE
    
    [OUTPUT]
        Name newrelic
        Match *
        licenseKey YOUR_LICENSE_KEY
    
    # Optional
    maxBufferSize 256000
    maxRecords 1024
  5. 次のコマンドを使用して、FluentBitインスタンスを再起動します。

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

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

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

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

    echo "test message" >> /PATH/TO/YOUR/LOG/FILE
  2. NewRelicのログUItest 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のいずれかを使用してください。

ログデータを表示する

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

SELECT * FROM Log

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

次は何ですか?

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

ログ転送を無効にする

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

Copyright © 2022 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.