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

ログ転送用の New Relic の Kubernetes プラグインを使用すると、クラスターからNew Relic Logsへのログの送信が簡素化されます。スタンドアロンのdockerイメージを使用し、DaemonSet として実行し、一元的な分析とトラブルシューティングのためにログをシームレスに収集します。 Kubernetes ログを New Relic に転送すると、ログデータの収集、処理、探索、クエリ、アラートを行うための l 機能が強化されます。

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

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

このページ New RelicKubernetesの手順に従って、インテグレーションをインストールします。このインテグレーションには、ログ用のKubernetesプラグインが含まれています。
オプションとして、ガイド付きインストールのステップ 4で、newrelic-logging リポジトリで利用可能な多数の設定オプションを使用して、インストレーションをさらに調整することもできます。ただし、ほとんどのユーザーにとって有効なので、標準設定をお勧めします。
重要
Kubernetesシークレットを使用してNew Relicポータルを保存している場合、newrelic-logging チャートはデフォルトでログを US API トークンに送信します。ライセンスキーが EU または FedRAMP アカウントに属しており、キーの保存にシークレットが使用されている場合は、 APIリファレンスドキュメントの適切な値でタスク設定を更新する必要があります。 EU アカウントでこれを設定する方法の例を次に示します。
newrelic-logging: enabled: true endpoint: https://log-api.eu.newrelic.com/log/v1
トラフィックを生成して数分待ってから、アカウントのデータを確認してください。

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

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

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

ログ転送インストレーション用のKubernetesプラグインのトラブルシューティング

場合によっては、ログ転送用の Kubernetes プラグイン ( newrelic-logging Helm チャート) を正しくインストールしたにもかかわらず、ログの正しい配信に影響するパフォーマンスの問題が発生することがあります。このような状況では、ログフォワーダーの内部メトリクスを確認すると、潜在的なボトルネックの原因を理解するのに役立ちます。

newrelic-logging Helm チャートは、特定の Kubernetes クラスタに対してこのようなメトリックの収集を有効にする設定を提供します。また、 New Relicでこれらすべてのメトリックを簡単に表示できるように、JSON 形式のダッシュボードテンプレートも提供しています。

Kubernetes クラスタを構成して、ログフォワーダーの内部メトリックを送信し、ダッシュボードに表示するには、次の手順に従います。

次の追加の構成設定を使用して Helm チャートをインストールします。
```
newrelic-logging:
  fluentBit:
    sendMetrics: true
```
Kubernetes クラスタを tr する場合にのみ、 newrelic-logging.fluentBit.sendMetrics設定を有効にする必要があります。トラブルシューティングを容易にするために、一度に 1 つの Kubernetes クラスタに対して有効にすることをお勧めします。
このダッシュボードテンプレートファイルをダウンロードします。これをテキストエディターで開き、 YOUR_ACCOUNT_IDの出現箇所 (合計 49 個) すべてをNew Relic アカウント IDに置き換えます。
次の手順に従って、結果のダッシュボードを JSON 形式でインポートします。
インポートされたダッシュボードは、ダッシュボードページでKubernetes Fluent Bit monitoringとして利用できるようになります。

追加のメトリクスの詳細

newrelic-logging Helm チャートは、 Fluent Bitと New Relic のnewrelic-fluent-bit-output プラグインを使用して、ログを New Relic に送信します。 fluentBit.sendMetrics設定オプションにより、個々のメトリックの収集が可能になります。

Fluent Bit 内部メトリクス: Fluent Bit によって Prometheus 形式で出力され、New Relic の Prometheus エクスポートエンドポイントに配信されます。これらは、 cluster_name 、 node_name 、 pod_nameによってファセット化できます。
newrelic-fluent-bit-output の内部プラグインメトリクス: 出力プラグインによって収集され、 New RelicのメトリクスAPIに送信されます。これらのメトリックにはcluster_nameディメンションのみが含まれるため、特定のクラスタに絞り込むことはできますが、特定のホストまたはポッドに絞り込むことはできません。これらは、ログを New Relic Logs API に配信する際の全体的なレイテンシを評価したり、潜在的なパッケージングの問題を観察したりするのに役立ちます。

Fluent Bit の内部メトリックを取得するには、prometheus_scrape INPUT プラグインとprometheus_remote_write OUTPUT プラグインを組み合わせて使用します。すべての Prometheuscounter メトリックは実際には 累積カウンター ですが、に取り込まれると自動的に デルタ変換が 実行され、後でNew Relic NRQLを使用してクエリを実行できるようになります。詳細はここをご覧ください。

ログデータを表示する

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

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

SELECT * FROM Log

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

ログ転送を無効にする

ログ転送機能を無効にするには、ここで説明する手順に従って Kubernetes プラグインをアンインストールします。New Relic では他に何もする必要はありません。

次は何ですか？

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

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