Operations Manual: logs and alarms

インデックス

概要

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

このエージェントが Node.js 用の Iot Agent ライブラリを使用するため、このエージェントの特定のものを加えて、アラームとログのエラーを発生させることができます。これらの詳細については、Iot Agent ライブラリ操作マニュアル を参照してください。

Logs

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

コマンドエラー

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

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

COMMANDS-002: Could not find any API Key information for device.

コマンドのターゲットとされるプロビジョニングされたデバイスに対して定義された APIKey がないことを示します。このエラーログは本番環境では発生しません。設定に属していないデバイス用にデフォルトのAPIKeyが設定されている必要があります。それが発生した場合は、defaultKey 設定プロパティを確認してください。

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

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

COMMANDS-004: Error handling incoming command for device [%s]

コマンドをデバイスに送信する際に問題が発生しました。このエラーがときどき、あるデバイスだけで起こる場合、その特定のデバイスに問題があることを示している可能性があります。接続の切断、デバイスのシャットダウンなどです。頻繁に発生する場合は、サウスバウンド接続に問題があることを示します。

COMMANDS-005: Error updating error information for device [%s]

このエラーログは、 Iot Agent がデバイスに情報を送信中にエラーを報告しようとしたときに、接続の問題が発生したことを示します。このログが表示された場合、 IoTAgent には、サウスとノースのネットワークインターフェイスの両方に問題があり、おそらく IoTA の一般的なネットワークアクセスの問題を示している可能性があります。

測定エラー

MEASURES-001: Couldn\'t find device data for APIKey [%s] and DeviceId[%s]

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

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

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

MEASURES-003: Parse error parsing incoming MQTT message [%]

MQTT メッセージ・ペイロードの解析中にエラーが見つかりました。これは、新しいクライアントがソフトウェアをプラットフォームに統合している場合に発生します。つまり、ペイロードには適切な Ultralight 2.0 形式がありません。通常、これはクライアント自体によってのみ解決できるエラーです。

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

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

MEASURES-005: Error before processing device measures [%s]

このエラーは、IoTA が一連の MQTT 測定を処理しているが、それらが属する装置を見つけることができない場合に発生します。通常、プロビジョニングされていないデバイスや不正なデバイスが原因です。

MEASURES-006: Error before processing device measures [%s]

グローバルエラー

GLOBAL-001: Error subscribing to topics: %s

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

GLOBAL-002: Couldn\'t connect with MQTT broker: %j

この致命的なエラーは、 IoTAgent が Mosquitto MQTT Brokerへの初期接続を確立できない場合に発生します。このエラーが発生した場合は、Mosquitto MQTT Brokerが起動していることを確認し、 IoTAgent から Broker への接続性をチェックします。

アラーム

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

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

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

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

エラー・コード

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

プレフィックス オペレーションのタイプ
GLOBAL Global errors
MEASURES Errors related with measure processing
COMMANDS Errors related with command processing