• /
  • EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

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

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

ktranslate」Dockerコンテナの管理

このページでは、New Relic のネットワーク監視で使用されるktranslateコンテナの管理オプションの概要を説明します。

コンテナの要件

ktranslateコンテナ イメージには次のリソースをお勧めします。

Disk

  • 100MBの利用可能なディスクスペース

CPU

  • SNMPポーリング/トラップ収集。約1,000台のデバイスに対して1CPUコアを使用
  • デバイスのフロー収集。約2,000フロー/秒(fps)ごとに1CPUコアを使用
  • Syslogメッセージの収集。1秒間に約2,000件のメッセージに対して1つのCPUコアを使用

Memory

ヒント

KTranslate コンテナ イメージは、一度に 1 つの「ジョブ タイプ」を実行します。たとえば、SNMP ポーリングとトラップ コレクション用にデプロイされたコンテナは、フロー コレクションには使用されません。さらに、フロー コレクション用にデプロイされたコンテナは、コンテナごとに 1 つの-nf.sourceタイプに制限されています。これは、単一の Docker ホストに複数のコンテナを同時にデプロイすることが一般的であることを意味します。また、共通の構成ファイルを共有することもできますが、その必要はありません。

コンテナの更新

ktranslateコンテナ イメージを最新の状態に保つことは、最新の更新を受信し、開発ライフサイクル中に適用されるさまざまなバグ修正を通じて一般的な問題を解決するために推奨されます。 コンテナを再デプロイするときは、常に最新の利用可能なイメージをプルすることをお勧めします。

  1. 以下のいずれかを実行して、利用可能な最新のコンテナイメージを引き出します。

    • DockerHub
      bash
      $
      docker pull kentik/ktranslate:v2
    • Quay.io
      bash
      $
      docker pull quay.io/kentik/ktranslate:v2
  2. 既存のコンテナのIDと名前を収集します。

    bash
    $
    docker ps -a --filter ancestor=kentik/ktranslate:v2 --format "{{.ID}} - {{.Names}}"

    出力例。

    3297b134a352 - ktranslate-snmp
    4962a854b386 - ktranslate-sflow
  3. 既存の容器の撤去

    bash
    $
    docker rm -f $CONTAINER_ID
  4. SNMPフロー データ、またはsyslog コレクションのいずれかでデプロイした元の設定を使用して、 ktranslateコンテナを再デプロイします。

重要

ktranslateで使用される設定ファイルは実行時にコンテナに適用されます。 このファイルを変更するには、統合検出ジョブを使用する場合を除き、実行中のコンテナを削除して再起動し、編集内容を適用する必要があります。

コンテナのランタイムオプション

以下は、 Dockerランタイム中に ktranslate コンテナ イメージに対して使用できるさまざまなオプションです。

オプション名

タイプ

必須

説明

-snmp

✓✓

実行時にオプションとして渡されたDockerホストからのボリュームマウントに基づいて、Dockerコンテナ上のsnmp-base.yamlファイルへのパスを設定します。

-nr_account_id

✓✓

ktranslateがデータを送信する New Relic アカウント ID。

-log_level

ktranslateのデフォルトのinfoログレベルをオーバーライドします。 使用可能なオプションはdebuginfowarn 、またはerrorです。

-snmp_discovery

コンテナーをSNMP検出モードでセットアップして、単一の検出ジョブを実行し、提供されたYAML構成ファイルを更新して、終了するために使用されます。

-snmp_discovery_min

固定間隔で実行するようにスケジュールされた SNMP ポーリング コンテナ内でintegrated discovery jobsを設定するために使用されます。 この設定により、検出ジョブが実行され、提供された YAML 構成ファイルが更新され、SNMP ポーリング コンテナーで SNMP 収集スレッドが再起動され、検出されたデバイスのコンテナー全体を破棄/再起動する必要がなくなります。

-snmp_discovery_on_start

-snmp_discovery_minフラグが設定されている場合、KTranslate は-snmp_discovery_minで定義された X 分ごとに加えて、コンテナーの開始時にすぐに検出ジョブを実行します。-snmp_discovery_minが設定されていない場合、このフラグは効果がありません。

-snmp_poll_now

オンデマンドでターゲットデバイスをポーリングするようにコンテナを設定するために使用します。

-tee_logs

Dockerを ktranslate からNew Relic Logsに転送します。

-metrics=jchf

ヘルスメトリクスをktranslateから New Relic に転送します。

-service_name

Dockerログのコンテナ名に追加され、NewRelicLogのさまざまなコンテナからログを分離できるようになります。

-nr_region

テレメトリーをNew Relicに転送するために、ktranslate のリージョン API エンドポイントを設定します。 オプションはUSEU 、およびGOV (FedRAMP) です。

-max_threads

大量のデータを処理できます。送信されるネットワークフローデータの毎秒2,000フロー(fps)ごと、監視対象のSNMPデバイス1,000ごと、またはコンテナによって収集される毎秒2,000のsyslogメッセージごとに1つのCPUコアを使用することをお勧めします。デフォルトは1です。

-sample_rate

フローがNewRelicイベントに渡されるデフォルトのサンプルレート値を変更します。これにより、デバイスのフローサンプルレートのローカル構成が高速化されることはありませんが、速度が低下する可能性があります。これを1に設定すると、コンテナに送信されたすべてのフローをキャプチャできるようになります。デフォルトは1000です。

-nf.workers

ネットワークパケットの処理に使用されるワーカーの数を上書きします。送信されるネットワークフローデータの毎秒4,000フロー(fps)ごとに1つのワーカーを使用します。デフォルトは2です。

-nf.port

着信フローパケットのリスニングポートを上書きします。デフォルトは9995です。

-nf.source

このコンテナが処理するフローのタイプを設定します。オプションはautoasaipfixnbarnetflow5netflow9pan 、およびsflowです。

-application_map

ランタイム中にオプションとして渡されたDockerホストからのボリュームマウントに基づいて、Dockerコンテナ上の アプリケーションマップ ファイルへのパスを設定します。

-dns

IP アドレスの DNS 解決中に使用するktranslateIP:Portを設定します。 これを設定すると、 dst_hostsrc_hostフィールドの結果に影響します。

nr1.flow

議論

✓ (フロー容器の場合)

この引数は、フラグcompression: gzipsink: new_relicformat: new_relicmax_before_sample: 100flow_only: truenf.source: autoを静的に設定します。

nr1.snmp

議論

✓ (SNMPコンテナの場合)

この引数は、次のオプションを静的に設定します: compression: gzipsink: new_relicformat: new_relic_metricmax_flows_per_message: 100

nr1.syslog

議論

✓ (syslogコンテナの場合)

この引数は、次のフラグを静的に設定します: compression: gzipsink: new_relicformat: new_relic_metricsyslog:"0.0.0.0:5143"

-syslog.format

syslog メッセージを解析するための形式。 オプションはAutomatic|RFC3164|RFC5424|RFC6587|NoFormatです。 デフォルト: Automatic

NoFormat RFC 標準に準拠していないメッセージを処理するには、明示的に設定する必要があります。

-syslog.source

Syslog サーバーを実行する IP:ポート タプル。 デフォルト: 0.0.0.0:5143

NEW_RELIC_API_KEY

環境変数

✓✓

DockerNew Relicktranslateにデータを送信するために、New RelicAPI ランタイム中に、 用の を保持するために使用する必要がある環境変数。例: -e NEW_RELIC_API_KEY=$LICENSE_KEY

HTTPS_PROXY

環境変数

プロキシ経由で にデータを送信するように をセットアップするために ランタイム中に使用できる環境変数。DockerktranslateNew Relic例: -e HTTPS_PROXY=https://user:password@hostname:port

KENTIK_PING_PRIV

環境変数

docker 実行時に使用できる環境変数。ICMP パケットのデフォルトの特権モードではなく、非特権モードで使用される UDP パケットを使用するようにktranslate's response_time | ping_only設定を設定します。 デフォルト: true

KENTIK_MERAKI_API_KEY

環境変数

Dockerランタイム中にMeraki ダッシュボード API キーをktranslate に渡すために使用できる環境変数。 例: -e KENTIK_MERAKI_API_KEY=$DASHBOARD_API_KEY

さまざまなクラウドプロバイダー環境変数

環境変数

dockerランタイム中に AWS、Azure、または GCP からシークレットを取得するために使用できる環境変数。

Copyright © 2024 New Relic株式会社。

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