オペレーション・マニュアル : ログとアラーム

目次

概要

次のドキュメントは、JSON IoT Agent のログファイルに表示されるすべてのエラーを示し、重大度とそのエラーに対処する方法を簡単に示しています。

ログ

次のセクションには、カテゴリ別に分類された IoT Agent ログに表示されるエラーログのエントリが含まれています。

コマンドエラー

COMMAND-001: Command execution could not be handled, as device for entity [%s] [%s] wasn\'t found

登録されていないエンティティに対してコマンドが受信されたことを示します。これは、Context Broker の登録を削除せずに、デバイスが IoT Agent から削除されたことを意味します。エンティティにプロビジョニングされたデバイスが存在するかどうかを確認し、存在しない場合は、存在しないデバイスの Context Broker の登録を削除します。

COMMANDS-002: Couldn\'t update command status in the Context broker for device [%s] with apiKey [%s]: %s

Context Broker に接続中に通信エラーが発生し、コマンド・ステータスを更新できなくなりました。このエラーが表示された場合、コマンドのステータスは矛盾したままになります。このログが頻繁に表示される場合は、 IoT Agent と Context Broker の間にネットワークの問題がある可能性があります。 IoT Agent ネットワーク接続と、設定済みのContext Brokerポートとホストを確認します。

設定の取得

CONFIG-001: Couldn\'t get the requested values from the Context Broker: %s

クライアント・デバイスは、Context Broker に存在しない、いくつかの属性をリクエストしました。これは、通常、クライアントが Context Broker に適切な値を書き込んでいないか、リクエスト内の異なる ID を送信したデバイスにエラーがあったことを意味します。Context Broker との通信でエラーが発生することがあります。

CONFIG-002: There was an error subscribing device [%s] to attributes [%j]

IoT Agent はリクエストされたエンティティにサブスクライブできませんでした。ほとんどの場合、これはContext Broker との通信に問題があることを示します。Context Broker の他の通信関連の問題を探して確認してください。

CONFIG-003: Unknown command type from device [%s]

使用可能な値ではないタイプのデバイスから設定リクエストを受信しました : "configuartion" または "subscription"。これは常にクライアント側のエラーです。

Thinking Things エラー

TTHINGS-001: Too few fields parsing Battery module: %s

バッテリのペイロードの読み込みエラーを解析します。これは、クライアント側で常にエラーとなり、ドキュメントにリダイレクトされます。

TTHINGS-002: Too few fields parsing GSM module: %s

GSM のペイロードの読み込みエラーを解析します。これは、クライアント側で常にエラーとなり、ドキュメントにリダイレクトされます。

TTHINGS-003: Too few fields parsing C1 module: %s

C1 のペイロードの読み込みエラーを解析します。これは、クライアント側で常にエラーとなり、ドキュメントにリダイレクトされます。

測定エラー

MEASURES-001: Bad payload received while processing timestamps

タイムスタンプ挿入プラグインは、プラグインがタイムスタンプを書き込めないように間違った形式のオブジェクトを検出しました。このオブジェクトは内部コードで書かれているので、このようなことは起こりません。もしそうであれば、それは以前のエラーの結果であるか、コード内のバグを示すでしょう。

MEASURES-002: Couldn\'t send the updated values to the Context Broker due to an error: %s

Context Broker に接続する際に通信エラーが発生し、測定値を送信できなくなりました。このログが頻繁に表示される場合は、IoT Agent と Context Broker の間にネットワークの問題がある可能性があります。IoT Agent ネットワーク接続と、設定済みの Context Broker ポートとホストを確認します。

MEASURES-003: Impossible to handle malformed message: %s

受信した MQTT メッセージに有効な JSON ペイロードが含まれていませんでした。これは、通常、クライアント側のエラーによって発生します。JSON 自体の形式が正しくないか、IoT Agent がデコードできないようにエンコードされているかのいずれかです。

MEASURES-004: Device not found for topic [%s]

このエラーログは、プロビジョニングされていないデバイス または IoT Agentに登録されていない API Key のIoT Agentに、測定値が到着するたびに表示されます。これにはいくつかの原因があります : 使用する DeviceId または API Key のタイプミス。または対応する測定値の設定またはデバイスが削除されている可能性があります。設定とデバイスの両方をプロビジョニングするのを忘れた可能性があります。

MEASURES-005: Couldn\'t process message [%s] due to format issues.

無効な MQTT トピックでメッセージが受信されたことを示します。通常、これはクライアント自体によってのみ解決できるエラーです。

グローバルエラー

GLOBAL-001: Error subscribing to topics: %s

適切な MQTT トピックに Iot Agent をサブスクライブする際にエラーが発生しました。このエラーは、起動時にのみ発生する可能性があり、Iot Agent が起動しないようにする必要があります。このエラーが発生した場合は、Mosquitto MQTT Broker が起動していることを確認し、 IoT Agent から Broker への接続性をチェックします。

GLOBAL-002: Configuration error. Configuration object [config.http] is missing

IoT Agent の起動時に必須の "config.http" 設定パラメータが見つからなかったことを示します。これにより、IoT Agent が起動しなくなります。設定ファイルを確認し、有効になるように修正してください。

アラーム

次の表は、JSON IoT Agent ライブラリで発生させることができるアラームを示しています。すべてのアラームは、"Raising [%s]:" (ここで%sはアラーム名) というプレフィックスで始まるエラーログによって通知されます。すべてのアラームは、"Releasing [%s]" プレフィックスを持つ情報ログによって解放されます。これらのテキストは、汎用ログレコード形式の msg= フィールドに表示されます。

アラーム名 重大度 説明
MQTTB-ALARM Critical Mosquitto MQTT Brokerにアクセスする永続的なエラーを示します

重大度('severity')の基準は次のとおりです :

  • Critical : システムが動作していません
  • Major : システムにはサービスを低下させる問題があり、対処する必要があります
  • Warning : 通知する必要があることが起こっています

エラー・コード

すべてのエラーには、プレフィックスと ID で構成されるコードがあり、次の表にまとめられています :

Prefix Type of operation
GLOBAL Global errors
TTHINGS Thinking Things plugin errors
CONFIG Errors related with the configuration retrieval mechanism
MEASURES Errors related with measure processing
COMMANDS Errors related with command processing