Pythonエージェントのテスト

問題

新しいホストでPythonエージェントをインストールまたは実行する際に問題が発生した場合は、パッケージが正しくインストールされ、データコレクターサービスに連絡できるかどうかをテストしてください。データコレクターサービスに到達できない場合は、ファイアウォールがブロックされていることが原因である可能性があります。以下のネットワーク接続テストを実行して、問題の原因を絞り込みます。

解決

テスト接続

Python エージェントには、当社の コレクター への接続を検証できるテストアプリが組み込まれています。テストアプリで検証するには、New Relic の設定ファイルへのパスを指定して以下のコマンドを実行します。

newrelic-admin validate-config LOCATION_OF_NEWRELIC.INI

これにより、Python エージェントを使用してテストが実行されます。エージェントはサンプル データをエージェント構成ファイルに対応するアカウントに報告し、報告されたサンプル データのPython Agent Testという名前のテスト アプリが APM UI に表示されます。

テストが完了すると、UIにアプリが非アクティブと表示されます。標準的な手順に従って、 テストアプリ を APM インデックスから削除してください。

エラーのログを確認する

5分経ってもUIにデータが転送されない場合は、テストで出力されたメッセージと生成されたログファイルを確認してください。データコレクタサービスへのアクセスに問題があると思われる場合は、以下のトラブルシューティング手順をお試しください。

• ネットワーク構成の確認.
• チェック ホスト名のルックアップ.
• ネットワークトラフィックをルーティングする.

以下は、エラーメッセージの例です。

ネットワーク構成の確認

ネットワーク接続を確認するために、以下を実行します。

newrelic-admin network-config newrelic.ini

これと似たような結果を探してください。

host = 'collector.newrelic.com'
port = 0
proxy_host = None
proxy_port = None
proxy_user = None
proxy_pass = None
ssl = True

• ポート:ポート設定の値0は、SSL が有効かどうかに応じて80や443などの適切なポートが使用されることを示します。
• Proxy: プロキシを使用するようにエージェントを設定している場合は、プロキシ設定にこれが反映されていることを確認してください。プロキシ設定が指定されていなくても、インターネットへのHTTP接続が必要な場合は、エージェント設定ファイルに適切なプロキシ設定が記述されていることを確認してください。

ホスト名検索の確認

データコレクタが接続できないように見える場合。

1. プライマリデータコレクタのホスト名が、 dig や nslookup などの UNIX システムツールで解決できることを確認してください。
2. これが成功しない場合は、ホストのドメイン名リゾルバファイルの設定を確認してください。

次の例を見てみましょう。

$ dig collector.newrelic.com

; <<>> DiG 9.8.3-P1 <<>> collector.newrelic.com
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 62183
;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 4, ADDITIONAL: 4

;; QUESTION SECTION:
;collector.newrelic.com.                IN      A

;; ANSWER SECTION:
collector.newrelic.com. 2453    IN      A       50.31.164.140

;; AUTHORITY SECTION:
newrelic.com.           1163    IN      NS      ns2.p21.dynect.net.
newrelic.com.           1163    IN      NS      ns1.p21.dynect.net.
newrelic.com.           1163    IN      NS      ns4.p21.dynect.net.
newrelic.com.           1163    IN      NS      ns3.p21.dynect.net.

;; ADDITIONAL SECTION:
ns1.p21.dynect.net.     3198    IN      A       208.78.70.21
ns2.p21.dynect.net.     8576    IN      A       204.13.250.21
ns3.p21.dynect.net.     7364    IN      A       208.78.71.21
ns4.p21.dynect.net.     8576    IN      A       204.13.251.21

;; Query time: 22 msec
;; SERVER: 192.168.178.1#53(192.168.178.1)
;; WHEN: Tue Jun 11 18:58:23 2013
;; MSG SIZE  rcvd: 206

ネットワークトラフィックのルーティングの確認

データコレクタホストのホスト名が解決できる場合は、 ping や traceroute などの UNIX システムツールを使用して、ネットワークトラフィックがそこにルーティングできるかどうかを確認します。ネットワークトラフィックの経路はさまざまです。最終的に目的のホストに到達していれば、パスの長さやホストは重要ではありません。

データコレクタのホストと連絡が取れない場合は、エージェントがファイアウォールのHTTPプロキシを使用するように設定するか、ファイアウォールで必要な送信ポートを開いてデータコレクタへの接続を許可します。

$ ping collector.newrelic.com
PING collector.newrelic.com (50.31.164.140): 56 data bytes
64 bytes from 50.31.164.140: icmp_seq=0 ttl=239 time=234.204 ms
64 bytes from 50.31.164.140: icmp_seq=1 ttl=239 time=230.095 ms
...

$ traceroute -p 80 collector.newrelic.com
traceroute to collector.newrelic.com (50.31.164.140), 64 hops max, 52 byte packets
 1  ...
 2  ...
 3  ...
 4  * * *
 5  collector.newrelic.com (50.31.164.140)  232.590 ms  231.000 ms  232.041 ms

$ traceroute -p 443 collector.newrelic.com
traceroute to collector.newrelic.com (50.31.164.140), 64 hops max, 52 byte packets
 1  ...
 2  ...
 3  ...
 4  * * *
 5  collector.newrelic.com (50.31.164.140)  253.513 ms  231.134 ms  232.511 ms