Open Telemetry アダプタの構成
ホームビューで、[設定]タブに行き、左側のペインで[サーバー接続]を選択します。
Open Telemetry ウィンドウで、次のパラメータを構成します。
フィールド
説明
オン/オフ
アダプタを有効化/無効化します。
機密データを公開する
IP アドレスや IMEI などの機密データをクライアントへエクスポートする機能を有効化/無効化します。
Prometheus スクレイピングを有効にする
Prometheus のスクレイピングエンドポイント (/metrics) 用の HTTP サーバーを有効にします。
Prometheus ポート
HTTP サーバーがリッスンするポートを構成します。
この設定は、Prometheus が有効になっている場合にのみ表示されます。
Prometheus 認証
Prometheus のスクレイピングに対する基本認証を有効にします。
この設定は、Prometheus が有効になっている場合にのみ表示されます。
ユーザー名
スクレイピング時に使用するユーザー名を入力します。
この設定は、Prometheus 認証が有効になっている場合にのみ表示されます。
パスワード
スクレイピング時に使用するパスワードを入力します。パスワードは伏せ文字ではなく、平文で表示されます。
この設定は、Prometheus 認証が有効になっている場合にのみ表示されます。
OTLP/HTTP プッシュを有効にする
OTLP/HTTPエクスポーターを有効にし、定期的な更新データの送信を開始します。
OTLP メトリックス URL
エクスポーターが protobuf 形式のデータを送信する宛先となる、OTLP/HTTP メトリクスエンドポイントを入力します。
この設定は、OTLP が有効になっている場合にのみ表示されます。
更新間隔
アダプタがツール/コントローラーからメトリクスデータをポーリングする間隔、およびそのデータを OTLP/HTTP エンドポイントへエクスポートする更新間隔です。
アダプタは、IAM 名で構成されたコントローラー名を、サービス名としてメッセージに付与します。IAM 名が空の場合、サービス名は px2system としてエクスポートされます。
Prometheus 情報メトリクス
静的なシステム情報は、OpenTelemetry の情報メトリクスとして送信されます。これらのデータはラベルで参照できます。
メートル法 | タイプ | 単位 | 説明 |
|---|---|---|---|
px2system_device_info | ゲージ | 1 | 静的な px2system のメタデータは、定数値「1」を持つ *_info 形式のメトリクスとしてエクスポートされます。 |
cellular_enabled | ゲージ | 1 | コントローラーの構成でセルラー通信が有効な場合は「1」、通信が存在するものの無効になっている場合は「0」となります。セルラー通信機能が搭載されている場合にのみ出力されます。 |
cellular_connection_info | ゲージ | 1 | セルラー通信機能が搭載されており、かつ有効な場合にのみ、定数値「1」として出力されます。 |
cellular_up | ゲージ | 1 | 最新のセルラーテレメトリのサンプルが有効で、かつすべての値が数値の場合は「1」、それ以外の場合は「0」になります。セルラー通信機能が搭載されており、有効な場合に出力されます (サンプルがない場合も出力されます)。セルラー通信が未接続の場合は「0」になります。 |
cellular_signal_sample_age_seconds | ゲージ | 秒 | 最新のセルラーデータサンプルを取得してからの経過時間 (秒)。サンプルが利用できない場合、またはサンプルが古い・無効な場合は「-1」になります。 |
cellular_signal_rsrp_dbm | ゲージ | dBm | 参照信号受信電力。cellular_signal_up==1 の場合にのみ出力されます。 |
cellular_signal_rsrq_db | ゲージ | dB | 参照信号受信品質。セルラー通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
cellular_signal_rssi_dbm | ゲージ | dBm | 受信信号強度インジケーター。セルラー通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
cellular_signal_snr_db | ゲージ | dB | 信号対雑音比。セルラー通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
cellular_signal_tx_dbm | ゲージ | dBm | 送信電力。セルラー通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
wifi_enabled | ゲージ | 1 | コントローラーの構成で Wi-Fi クライアントが有効な場合は「1」、通信が存在するものの無効になっている場合は「0」となります。Wi-Fi クライアント機能が搭載されている場合にのみ出力されます。 |
wifi_connection_info | ゲージ | 1 | Wi-Fi 機能が搭載されており、かつ有効で、Wi-Fi サンプルがある場合にのみ、定数値「1」として出力されます。 |
wifi_up | ゲージ | 1 | 最新の Wi-Fi サンプルが有効で、かつ値が数値の場合は「1」、それ以外の場合は「0」になります。Wi-Fi 機能が搭載されており、かつ有効になっている場合に出力されます (サンプルがない場合も出力されます)。Wi-Fi に未接続の場合は「0」になります。 |
wifi_signal_sample_age_seconds | ゲージ | 秒 | 最新の Wi-Fi データサンプルを取得してからの経過時間 (秒)。サンプルが利用できない場合、またはサンプルが古い・無効な場合は「-1」になります。 |
wifi_signal_rssi_dbm | ゲージ | dBm | Wi-Fi 受信信号強度インジケーター。Wi-Fi 機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
wifi_link_quality_percent | ゲージ | % | Wi-Fi リンク品質。Wi-Fi 機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
wifi_tx_bitrate_mbps | ゲージ | Mbit/s | Wi-Fiでネゴシエーション済みの最大送信ビットレート。Wi-Fi 機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
wifi_rx_bitrate_mbps | ゲージ | Mbit/s | Wi-Fiでネゴシエーション済みの最大受信ビットレート。Wi-Fi 機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
メートル法 | Label key | 機密 | メモ |
|---|---|---|---|
px2system_device_info | service_name | いいえ | 構成された IAM 名。空の場合は「px2system」として出力されます。 |
px2system_device_info | tool_serial | いいえ | ツール識別子。ツール識別子が利用可能な場合に出力されます。 |
px2system_device_info | tool_model | いいえ | ツールモデル識別子。ツール識別子が利用可能な場合に出力されます。 |
cellular_connection_info | technology | いいえ | 値の例: 「4G」、「5G」。セルラー通信が有効な場合に出力されます。 |
cellular_connection_info | pci | いいえ | 物理セルID。モデムから取得可能な場合に出力されます。 |
cellular_connection_info | carrier_name | いいえ | 通信事業者・オペレーター名。モデムから取得可能な場合に出力されます。 |
cellular_connection_info | carrier_mcc | いいえ | モバイル国コード (MCC)。モデムから取得可能な場合に出力されます。 |
cellular_connection_info | carrier_mnc | いいえ | モバイルネットワークコード (MNC)。モデムから取得可能な場合に出力されます。 |
cellular_connection_info | apn | はい | 構成済みのアクセスポイント名。exposeSensitiveData 設定によって出力が制御されます。 |
cellular_connection_info | ip_address | はい | セルラーモデムが使用する IP アドレス。機密データの公開設定によって出力が制御されます。 |
cellular_connection_info | imei | はい | モデムの国際移動体装置識別番号 (IMEI)。機密データの公開設定によって出力が制御されます。 |
cellular_connection_info | sim_iccid | はい | SIM カードのシリアル番号 (ICCID)。データが存在する場合にのみ、機密データの公開設定によって出力が制御されます。 |
cellular_connection_info | frequency_band | いいえ | セルラーモデムで使用される周波数帯。モデムから取得可能な場合に出力されます。 |
cellular_connection_info | bandwidth | いいえ | セルラーモデムで使用される帯域幅。モデムから取得可能な場合に出力されます。 |
cellular_connection_info | mtu | いいえ | 最大伝送単位。モデムから取得可能な場合に出力されます。 |
cellular_connection_info | imsi | はい | SIM の国際移動体加入者識別番号 (IMSI)。機密データの公開設定によって出力が制御されます。 |
wifi_connection_info | channel | いいえ | Wi-Fi チャネル。システムから取得可能な場合に出力されます。 |
wifi_connection_info | ssid | はい | Wi-Fi ネットワークの一意の名称。機密データの公開設定によって出力が制御されます。 |
wifi_connection_info | bssid | はい | アクセスポイント (AP) の一意の MAC アドレス。機密データの公開設定によって出力が制御されます。 |
wifi_connection_info | mac_address | はい | Wi-Fi カードの MAC アドレス。機密データの公開設定によって出力が制御されます。 |
wifi_connection_info | ipv4 | はい | Wi-Fi で使用される IP アドレス。機密データの公開設定によって出力が制御されます。 |
OTLP/HTTP 情報メトリクス
メートル法 | 単位 | 説明 |
|---|---|---|
cellular.enabled | 1 | コントローラーの構成でセルラー通信が有効な場合は「1」、それ以外は「0」となります。セルラー通信機能が搭載されている場合にのみ出力されます。 |
cellular.up | 1 | 最新のセルラーサンプルの値が数値の場合は「1」、それ以外は「0」となります。セルラー通信機能が搭載されており、かつ有効な場合に出力されます。サンプルがない/無効、つまり未接続の場合は「0」として出力されることがあります。 |
cellular.signal.sample_age | 秒 | 最新のセルラーデータサンプルを取得してからの経過時間 (秒)。サンプルが欠落している、または無効な場合は「-1」となります。 |
cellular.signal.rsrp | dBm | 参照信号受信電力。サンプル値が数値で、セルラー通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
cellular.signal.rsrq | dB | 参照信号受信品質。サンプル値が数値で、セルラー通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
cellular.signal.rssi | dBm | 受信信号強度インジケーター。サンプル値が数値で、セルラー通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
cellular.signal.snr | dB | 信号対雑音比。サンプル値が数値で、セルラー通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
cellular.signal.tx_power | dBm | 送信電力。サンプル値が数値で、セルラー通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
wifi.enabled | 1 | コントローラーの構成で Wi-Fi クライアントが有効な場合は「1」、それ以外は「0」となります。Wi-Fi クライアント機能が搭載されている場合にのみ出力されます。 |
wifi.up | 1 | 最新の Wi-Fi サンプルの値が数値の場合は「1」、それ以外は「0」となります。Wi-Fi 通信機能が搭載されており、かつ有効な場合に出力されます。サンプルがない/無効、つまり未接続の場合は「0」として出力されることがあります。 |
wifi.signal.sample_age | 秒 | 最新の Wi-Fi データサンプルを取得してからの経過時間 (秒)。サンプルが欠落している、または無効な場合は「-1」となります。 |
wifi.signal.rssi | dBm | Wi-Fi 受信信号強度インジケーター。サンプル値が数値で、Wi-Fi 通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
wifi.link.quality | % | Wi-Fi リンク品質。サンプル値が数値で、Wi-Fi 通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
wifi.link.tx_bitrate | Mbit/s | Wi-Fiでネゴシエーション済みの最大送信ビットレート。サンプル値が数値で、Wi-Fi 通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
wifi.link.rx_bitrate | Mbit/s | Wi-Fiでネゴシエーション済みの最大受信ビットレート。サンプル値が数値で、Wi-Fi 通信機能が搭載されており、有効かつ接続されている場合にのみ出力されます。 |
キー | 機密 | メモ |
|---|---|---|
service.name | いいえ | 構成された IAM 名。空の場合は「px2system」として出力されます。 |
tool.serial_number | いいえ | ツールのシリアル番号。少なくとも 1 つのドメインが存在し、かつ有効であり、ツールのシリアル番号を取得できる場合にのみ出力されます。 |
tool.model | いいえ | ツールのモデル。少なくとも 1 つのドメインが存在し、かつ有効であり、ツールのモデルを取得できる場合にのみ出力されます。 |
cellular.present | いいえ | セルラー通信が存在する場合 (無効になっている場合でも)、「true」として出力されます。システムにセルラー通信機能がない場合は「false」として出力されます。 |
cellular.radio.tech | いいえ | 値の例: 「4G」、「5G」。取得可能で、かつセルラー通信が有効な場合に出力されます。 |
cellular.carrier.name | いいえ | 通信事業者・オペレーター名。取得可能で、かつセルラー通信が有効な場合に出力されます。 |
cellular.carrier.mcc | いいえ | モバイル国コード (MCC)。取得可能で、かつセルラー通信が有効な場合に出力されます。 |
cellular.carrier.mnc | いいえ | モバイルネットワークコード (MNC)。取得可能で、かつセルラー通信が有効な場合に出力されます。 |
cellular.frequency.band | いいえ | セルラー周波数帯。取得可能で、かつセルラー通信が有効な場合に出力されます。 |
cellular.frequency.bandwidth | いいえ | セルラー帯域幅。取得可能で、かつセルラー通信が有効な場合に出力されます。 |
cellular.link.mtu | いいえ | 最大伝送単位。取得可能で、かつセルラー通信が有効な場合に出力されます。 |
cellular.pci | いいえ | 物理セル ID。取得可能で、かつセルラー通信が有効な場合に出力されます。 |
cellular.ip | はい | セルラーモデムの IP アドレス。セルラー通信が有効な場合に出力されます。機密データの公開設定によって出力が制御されます |
cellular.apn | はい | 構成されたアクセスポイント名。セルラー通信が有効な場合に出力されます。機密データの公開設定によって出力が制御されます |
cellular.imei | はい | モデムの国際移動体装置識別番号 (IMEI)。セルラー通信が有効な場合に出力されます。機密データの公開設定によって出力が制御されます |
cellular.imsi | はい | SIM の国際移動体装置識別番号 (IMSI)。セルラー通信が有効な場合に出力されます。機密データの公開設定によって出力が制御されます |
cellular.sim.iccid | はい | SIM カードのシリアル番号。データが存在する場合のみ、またセルラー通信が有効な場合に出力されます。機密データの公開設定によって出力が制御されます |
wifi.present | いいえ | Wi-Fi クライアントが存在する場合 (無効になっている場合でも)、「true」として出力されます。システムに Wi-Fi 機能がない場合は「false」として出力されます。 |
wifi.channel | いいえ | システムの Wi-Fi チャネル。Wi-Fi 機能が搭載されており、かつ有効な場合に出力されます。 |
wifi.ssid | はい | Wi-Fi ネットワークの一意の名前。Wi-Fi 機能が搭載されており、かつ有効な場合に出力されます。機密データの公開設定によって出力が制御されます |
wifi.bssid | はい | アクセスポイント (AP) の一意の MAC アドレス。Wi-Fi 機能が搭載されており、かつ有効な場合に出力されます。機密データの公開設定によって出力が制御されます |
wifi.mac_address | はい | Wi-Fi カードの MAC アドレス。Wi-Fi 機能が搭載されており、かつ有効な場合に出力されます。機密データの公開設定によって出力が制御されます |
wifi.ipv4 | はい | Wi-Fi で使用される IP アドレス。Wi-Fi 機能が搭載されており、かつ有効な場合に出力されます。機密データの公開設定によって出力が制御されます |
Prometheus 認証
OpenTelemetry で Prometheus 認証が有効になっている場合、クライアントは GET (スクレイピング) リクエストのAuthorization ヘッダーに正しいユーザー名とパスワードを送信する必要があります。認証情報がないか正しくない場合、サーバーは 401 Unauthorized で応答します。認証が優先されます。リクエストのパスが誤っている場合でも、サーバーは 401 を返します。認証情報が正しい場合、サーバーは認証が無効になっているかのように応答します。つまり、正しいパスの場合はスクレイピング結果とともに 200 を返し、誤ったパスでは 404 Not Found を返します。
使いやすさを優先する意図的なトレードオフとして、パスワードは OpenTelemetry ウィンドウに平文で保存・表示されます。この決定は、UI へのアクセスが制限されている管理された運用環境を対象としています。ユーザーは、管理インターフェースに対して適切なアクセス制御を適用することが求められます。
Prometheus のエラー処理
クライアントが /metrics 以外のパスをスクレイピングした場合、サーバーは HTTP 404 エラーを返します。認証が有効な場合のエラー処理については、「認証」セクションを参照してください。Prometheus が有効になっていない場合、クライアントのリクエストはタイムアウトします。
OTLP/HTTP エラー処理
エクスポーターは、OTEL コレクターへの永続的な (キープアライブ) 接続を使用します。初回のプッシュ時にレイジー接続を確立し、その後のプッシュではソケットを再利用します。接続に失敗した場合、可能な限りソケットの再利用を試みます。
エクスポート時に接続に失敗した場合、アダプタは連続再試行に対して、±25% のジッターを加えたバックオフポリシーを適用します。バックオフ時間は 30秒 に制限されています。10回連続で失敗した場合、アダプタは次の試行まで 5 分間待機します。
バックオフポリシーを適用する、再試行可能な HTTP 応答エラー:
エンドポイントに接続できません。
送信失敗/読み取り失敗 (接続を閉じて再試行します)。
HTTP 応答ステータス:
408 (タイムアウト)
429 (スロットリング)
すべての 5xx (サーバーエラー)。
再試行不可の障害 (設定が変更されるまで一時停止します):
すべての HTTP 4xx 応答。
無効なメトリクス URL。
https:// が設定されている場合 (TLS は非対応)
テレメトリサンプルが存在しない場合 (例えば、起動時)、アダプタはこれを障害とはみなさず、バックオフポリシーを適用しません。
