AWS IoT Core の監視

オンラインで編集する

「 Instana 」を使用して AWS IoT Core を監視し、 IoT 環境全体を包括的に把握しましょう。 AWS IoT Core を監視するには、お使いの環境に Instana エージェントをインストールしてください。エージェントは自動的に AWS IoT Core センサーを展開し、このセンサーが IoT のメトリクスを収集します。これらの指標は、 Instana のUIで確認できます。

注：AWS IoT Core は、デバイスを AWS クラウドに接続するためのクラウドサービスです。その他のサポート対象の AWS サービスについては、「 AWS 」のトピックを参照してください。

必要な IAM 許可

オンラインで編集する

AWS IoT Core センサーが AWS IoT Core を監視するには、以下の AWS IAM権限が必要です：

cloudwatch:GetMetricData
cloudwatch:GetMetricStatistics
iot:DescribeEndpoint
iot:ListThings

AWS IoT Core センサーの設定

オンラインで編集する

Instana エージェントのインストール後、 AWS IoT Core センサーはデフォルトで有効になります。 AWS IoT Core のメトリクスは60秒ごとに取得されます。この設定は、 <agent_install_dir>/etc/instana/configuration.yml ファイルで変更できます。

com.instana.plugin.aws.iotcore:
  cloudwatch_period: 60

プロキシ設定の有効化

オンラインで編集する

AWS IoT Core センサーでプロキシ設定を使用できるようにするには、以下のエージェント設定を追加してください：

com.instana.plugin.aws.iotcore:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password

AWS IoT Core センサーを無効にする

オンラインで編集する

IoT コア・インスタンスのモニターを無効にするには、以下の構成を使用します。

com.instana.plugin.aws.iotcore:
  enabled: false

複数の AWS アカウントにわたる AWS IoT Core の監視設定

オンラインで編集する

同じリージョン内に 1 つの AWS エージェントを持つ複数の AWS アカウントのモニターをセットアップするには、2 つの方法を使用できます。詳しくは、複数の AWS アカウントのモニターを参照してください。

AWS -命名済みプロファイル方式

オンラインで編集する

AWS IoT Core の監視に使用するプロファイルを上書きするには、以下の設定を使用してください：

com.instana.plugin.aws.iotcore:
  profile_names:
    - 'profile2'
    - 'profile3'

注：サービスレベルでプロファイルを定義した場合、グローバルな AWS プロファイルの設定は上書きされます。

AWS STS を使用する方法

オンラインで編集する

IoT コアのモニターに使用される IAM 役割をオーバーライドするには、以下の構成を使用します。

com.instana.plugin.aws.iotcore:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'

注：サービスレベルでIAMロールを定義した場合、グローバルな AWS のIAMロール設定は上書きされます。

タグを定義してフィルタリングする

オンラインで編集する

IoT Core ブローカーにタグを付けることはできないため、タグの定義によるフィルタリングはサポートされていません。

メトリックの表示

オンラインで編集する

メトリックを表示するには、以下のステップを実行します。

Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 を選択します。
監視対象の AWS IoT Core インスタンスを1つクリックします。

収集されたすべてのメトリクスが表示された AWS IoT Core のダッシュボードを確認できます。

構成データ

オンラインで編集する

AWS IoT Core センサーは、以下の IoT Coreデータを収集します：

エンドポイント
リージョン

メトリック

オンラインで編集する

次の表は、 AWS IoT Core センサーが収集するメトリクスの一覧です：


名前	説明
接続成功	メッセージ・ブローカーへの正常な接続の数。
接続スロットル	アカウントが許可されている接続要求率を超えたために調整された接続要求の数。
接続クライアントIDスロットル	クライアントが特定のクライアント ID に対して許可されている接続要求率を超えたためにスロットルされた接続要求の数。
合計接続スロットル	スロットルされている接続要求の総数。
ルール実行	実行された AWS IoT ルールの数。
Ping成功	メッセージ・ブローカーによって受信された ping メッセージの数。
接続認証エラー	メッセージ・ブローカーによって許可できない接続要求の数。
Connect クライアント・エラー	MQTT メッセージが AWS IoT 割り当て量で定義されている要件を満たしていなかったために拒否された接続要求の数。
接続サーバー・エラー	内部エラーが発生したために失敗した接続要求の数。
認証での公開エラー	メッセージ・ブローカーが許可できない公開要求の数。
クライアントへのパブリッシュ・エラー	メッセージが AWS IoT 割り当て量で定義された要件を満たしていなかったために、メッセージ・ブローカーによって拒否されたパブリッシュ要求の数。
サーバーへの公開エラー	内部エラーが発生したためにメッセージ・ブローカーが処理に失敗したパブリッシュ要求の数。
Publish In成功	メッセージ・ブローカーによって正常に処理されたパブリッシュ要求の数。
Publish Inスロットル	クライアントが許可されているインバウンド・メッセージ速度を超えたためにスロットルされたパブリッシュ要求の数。
パブリッシュ/アウト認証エラー	メッセージ・ブローカーによって発行されたパブリッシュ要求のうち、 AWS IoTで許可できないものの数。
パブリッシュ/アウト・クライアント・エラー	メッセージ・ブローカーによって発行されたパブリッシュ要求のうち、 AWS IoT 割り当て量で定義された要件をメッセージが満たしていなかったために拒否されたパブリッシュ要求の数。
Publish Out成功	メッセージ・ブローカーによって正常に行われたパブリッシュ要求の数。
Publish Outスロットル	クライアントが許可されているアウトバウンド・メッセージ速度を超えたためにスロットルされたパブリッシュ要求の数。
サブスクライブ成功	メッセージ・ブローカーによって正常に処理されたサブスクライブ要求の数。
サブスクライブ・スロットル	クライアントが許可されているサブスクライブ要求率を超えたためにスロットルされたサブスクライブ要求の数。
Thing Shadowの取得を受け入れ済み	正常に処理された GetThingShadow リクエストの数。
Thing Shadowの更新を受け入れ済み	正常に処理された UpdateThingShadow リクエストの数。
Thing Shadowの削除を受け入れ済み	正常に処理された DeleteThingShadow リクエストの数。
Thing Shadowのリスト表示を受け入れ済み	正常に処理された ListThingShadow リクエストの数。