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

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

LogstashのログをNew Relicに転送することで、ログデータの収集、処理、探索、クエリ、アラートなどのログ管理機能が強化されます。

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

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

A New Relic のライセンスキー
Logstashバージョン6.6以上 Java 8またはJava 11を使用しています。オラクルの公式ディストリビューションまたは、 OpenJDK などのオープンソースのディストリビューションを使用してください。

Logstashプラグインを使って、ログをNew Relicに転送する。

ターミナルまたはコマンドラインインターフェースに以下のコマンドを入力します。
```
logstash-plugin install logstash-output-newrelic
```

logstash.confファイルに、次のデータブロックを追加します。プレースホルダーテキストを必ずNewRelicライセンスキーに置き換えてください。

output {
  newrelic {
  license_key => "LICENSE_KEY"
  }
}

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インスタンスを再起動します。
次のコマンドを実行すると、テスト用のログメッセージがログファイルに追加されます。
```
echo "test message" >> /PATH/TO/YOUR/LOG/FILE
```
NewRelicのログUIでtest messageを検索します。

すべての設定が正しく行われ、データが収集されていれば、この2つの場所にデータログが表示されるはずです。

NewRelicのログUI
NRQL クエリを実行するための New Relic ツール NRQL クエリを実行するための New Relic ツール。例えば、以下のようなクエリを実行することができます。

SELECT * FROM Log

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

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

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

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