Ktranslate（NetworkPerformanceMonitoring）トラブルシューティングガイド

Ktranslate 調査ガイド

Published 2024년 9월 30일 1분 소요

New Relic network PerformanceMonitoringではKtranslate によってSNMPやFlowData、SyslogDataを収集します。

このKtransllateはコンテナもしくはLinux パッケージの形で提供されます。

この記事ではKtransllateを運用する際に必要となるトラブルシューティング手法をご案内します。

トラブルシューティングドキュメント

Ktranslateの基本的なトラブルシューティングに関するドキュメントは公式ドキュメントに用意されています。

公式ドキュメントではnetworkPerformanceEntityの確認方法やSNMPトラブルシューティング、Ktranslateサイジングについての情報が用意されています。

Ktranslteのlog確認

KtranslateがNew RelicPlaitformに接続出来ている場合はKtranslateのlogは自動的に収集され、New Relic Logs UIから確認出来ます。

Ktranslateのlogは以下のようなメタデータを持ってNew Relic Logs で確認できます。

{
  "collector.name": "ktranslate",
  "container_service": "SNMP-V2",
  "instrumentation.provider": "kentik",
  "logtype": "ktranslate-health",
  "message": "KTranslate 1/1024) Running with SNMP v2c",
  "newrelic.logPattern": "nr.DID_NOT_MATCH",
  "newrelic.source": "api.logs",
  "plugin.type": "ktranslate-health",
  "severity": "Info",
  "timestamp": 1723802916392
}

以下の様なNRQLで確認することもできます。

SELECT `level`,`message` FROM Log WHERE `instrumentation.provider` = 'kentik'

ローカルでのlog確認

Ktranslateのlogはテキストファイルには出力されません。導入環境に合わせてそれぞれ次のようなコマンドでlogを確認してください。

Ktranslate Containerの場合

以下のコマンドでlogを確認します。

docker logs ktranslate-$CONTAINER_SERVICE

ktranslate-$CONTAINER_SERVICE 部分はKtranslate コンテナ起動時に設定したContainer Name を指定します。

Ktranslate パッケージの場合

以下のコマンドでlogを確認します。

journalctl -u ktranslate

Ping Monitoringが動作しない

Ktranslate Package版の場合はICMP Echo Socketの権限が不足してPing Monitoringが動作しない場合があります。

この場合以下のようなErrorがlogに記録されます。

Cannot ping: listen ip4:icmp : socket: operation not permitted

この場合はKtranslateの環境変数を設定し、ICMPパケットを特権モードで利用出来るようにします。

環境変数を設定

KENTIK_PING_PRIV=false

Ktranslate デバッグプログラム

実験的なプロジェクトでありNew Relic テクニカルサポートのサポート範囲外となりますが、Ktranslate コンテナの自己診断プログラムが公開されています。

newrelic-npm-diagnostics

npmDiag は、お客様の Network Performance Monitoring 環境からログと設定ファイルを収集し、サポートのために New Relic に提供可能な ZIP ファイルを作成します。

まとめ

New Relic の公式ドキュメント以外にもKtranslateの状態を確認するためのlogの確認方法や設定方法

情報収集プログラムが用意されています。

Ktranslateの動作情報を収集し、New Relic NPMの運用にお役立てください。

伊藤覚宏, LeadTechnicalSupportEngineer

New Relic株式会社　リードテクニカルサポートエンジニア OSSの運用監視ソフトウェアの日本におけるテクニカルサポート、テクニカルトレーニングの立ち上げを行い、VMwareベースのクラウドサービス開発、AWSテクニカルサポート、クラウドアーキテクトを経て現職。テクニカルサポート、テクニカルトレーニング、運用コンサルを専門領域としてお客様の運用負荷軽減を目指す。得意分野は運用設計、クラウド設計、OSSソフトウェア。

이 블로그에 표현된 견해는 저자의 견해이며 반드시 New Relic의 견해를 반영하는 것은 아닙니다. 저자가 제공하는 모든 솔루션은 환경에 따라 다르며 New Relic에서 제공하는 상용 솔루션이나 지원의 일부가 아닙니다. 이 블로그 게시물과 관련된 질문 및 지원이 필요한 경우 Explorers Hub(discuss.newrelic.com)에서만 참여하십시오. 이 블로그에는 타사 사이트의 콘텐츠에 대한 링크가 포함될 수 있습니다. 이러한 링크를 제공함으로써 New Relic은 해당 사이트에서 사용할 수 있는 정보, 보기 또는 제품을 채택, 보증, 승인 또는 보증하지 않습니다.

Ktranslate（NetworkPerformanceMonitoring）トラブルシューティングガイド

780+ 개 통합을 사용해 무료로 스택 모니터링

모든 통합 보기

In this article

Ktranslate（NetworkPerformanceMonitoring）トラブルシューティングガイド

Ktranslate 調査ガイド

トラブルシューティングドキュメント

Ktranslteのlog確認

ローカルでのlog確認

Ktranslate Containerの場合

Ktranslate パッケージの場合

Ping Monitoringが動作しない

Ktranslate デバッグプログラム

まとめ

Tags

관련