ログフォワーディングのためのLogstashプラグイン

ログデータがすでに Logstash によって監視されている場合は、当社の Logstash プラグインを使用して、New Relic でログデータを転送し、エンリッチすることができます。

Logstash ログをNew Relicに転送すると、ログデータの収集、処理、探索、書き込み、集計の機能が強化されます。

ログ管理のためのLogstashの有効化

LogstashからNew Relicにログを転送するために。

あなたが持っていることを確認してください：
- New Relic
- Logstashバージョン6.6以上 Java 8またはJava 11を使用しています。オラクルの公式ディストリビューションまたは、 OpenJDK などのオープンソースのディストリビューションを使用してください。
Logstashプラグインのインストールと設定を行います。
オプションです。追加のプラグイン属性の設定。
テスト Logstashプラグインを使用しています。
トラフィックを生成して数分待ってから、アカウントのデータを確認してください。

Logstash プラグインを使用してログを New Relic に転送するには:

ターミナルまたはコマンドラインインターフェースに以下のコマンドを入力します。
bash
```
$logstash-plugin install logstash-output-newrelic
```
logstash.confファイルに、次のデータブロックを追加します。必ずプレースホルダーテキストを New Relic に置き換えてください。
```
output {
  newrelic {
    license_key => "LICENSE_KEY"
  }
}
```
Logstashインスタンスを再起動します。

Logstash プラグインをインストールして設定した後、以下の属性を使用して、プラグインが New Relic にデータを送信する方法を設定することができます。属性の追加や設定の詳細については、GitHub Logstash の設定例をご覧ください。

プロパティ	説明
`concurrent_requests`	リクエストを行うスレッドの数。デフォルト： `1`
`base_uri`	New Relicのインジェストエンドポイント。米国のエンドポイント： `https://log-api.newrelic.com/log/v1` EUエンドポイント： `https://log-api.eu.newrelic.com/log/v1`
`max_retries`	メッセージの送信を再試行する最大試行回数。 `0`に設定すると、再試行は行われません。デフォルト： `3`

プロパティ

説明

concurrent_requests

リクエストを行うスレッドの数。デフォルト： 1

base_uri

New Relicのインジェストエンドポイント。

max_retries

メッセージの送信を再試行する最大試行回数。 0に設定すると、再試行は行われません。デフォルト： 3

Logstashプラグインがログファイルからの入力を受け取っているかどうかをテストする。

logstash.confファイルに以下を追加します。

input {
  file {
    path => "/PATH/TO/YOUR/LOG/FILE"
  }
}

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

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

SELECT * FROM Log

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

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

ログ転送機能を無効にするには、 Logstash documentation の標準的な手順に従います。New Relic では、他に何もする必要はありません。