監視 Envoy Proxy

特使標誌

Instana 可協助您從 Envoy Proxy 實例收集基礎架構度量值，以及透過它們傳遞之要求的分散式追蹤資料。

安裝 Instana 主機代理程式之後，會自動安裝並配置 Envoy Proxy 感應器。您可以使用自訂儀表板小組件，在 Instana 使用者介面中檢視與 Envoy Proxy 相關的度量值。只有在配置 Envoy Proxy 感應器之後，才能檢視這些度量，如 Envoy Proxy 的監視配置小節中所述。

若要使用「分散式追蹤」特性，您需要完成 Envoy Proxy 的分散式追蹤配置區段中的配置步驟。

支援的資訊
- 支援的作業系統
- 支援的 Envoy Proxy 版本和平台
Envoy Proxy 的監視配置
使用 Envoy Proxy 感應器的監視配置 1.0.2 或更舊版本
檢視度量值
Envoy Proxy 的分散式追蹤配置
Envoy 追蹤範例
疑難排解

支援的資訊

支援的作業系統

對於 Envoy Proxy 感應器，支援的作業系統與主機代理程式的需求一致，可以在每一個主機代理程式的「支援的作業系統」區段中進行檢查，例如 Linux支援的作業系統。

對於 Envoy Proxy 追蹤，支援下列作業系統:

作業系統	架構	位元
Alpine Linux	x86_64	64 位元
Amazon Linux: 2 ， 2022	x86_64	64 位元
CentOS: Centos 7	x86_64	64
Debian: 11、10	x86_64	64 位元
Ubuntu:LTS	x86_64	64 位元

支援的 Envoy Proxy 版本和平台

「特使 Proxy」感應器和「特使 Proxy」追蹤具有不同的版本和平台需求。

在 x86_64 架構上執行的 Linux 發行套件中，特使 Proxy 感應器支援 Envoy Proxy 1.14.1 以及更新版本的度量及配置資料。

附註: 只能在自訂儀表板小組件中使用 Envoy Proxy 度量值。
Instana 提供下列 Envoy Proxy 版本及作業系統的「分散式追蹤」支援:
- 特使 Proxy 1.15.x 至最新，適用於具有最新追蹤程式二進位檔的 glibc 型 Linux x86_64 (> = 1.5.0)
- getvoy for glibc-based Linux x86_64 中的最新 Envoy Proxy 版本，具有最新追蹤程式二進位檔
- 適用於 glibc 型及 Alpine型 (musl libc) Linux x86_64 (含追蹤器二進位檔 1.3.0) 的特使 Proxy 1.12.x 及 1.13.x 。
附註：
- 對於「分散式追蹤」， Envoy Proxy 感應器 1.3.0支援 Envoy Proxy 1.12 和 1.13 。特使 Proxy 感應器 1.5.0 以及更新版本僅支援 Envoy Proxy 1.15 以及更新版本。如果您仍使用 Envoy Proxy 的舊版本，則建議您升級 Envoy Proxy ，因為沒有為舊版 Envoy Proxy 提供任何特性開發。
- Envoy Tracer 1.8.0支援傳播 W3C 追蹤環境定義標頭。

Envoy Proxy 的監視配置

為了收集 Envoy Proxy 度量值， Instana 使用管理介面。若要啟用此管理介面，請使用基於管理介面文件的管理介面位址來配置 Envoy Proxy 伺服器。使用 -c <envoy-config-file-path>.yaml 或 --config-path <envoy-config-file-path>.yaml 指令行引數來啟動伺服器。例如， -c /etc/envoy/envoy.yaml。從 Envoy Proxy 感應器 1.1.0開始，支援容器化環境及 YAML 配置剖析。

使用 Envoy Proxy 感應器的監視配置 1.0.2 或更舊版本

特使 Proxy 感應器 1.0.2 或更舊版本還需要 --admin-address-path <path-to-file-envoy-can-write-to> 指令行引數。例如，--config-path /etc/envoy/envoy.yaml --admin-address-path /tmp/envoy-admin.address。若要讓監視運作， Instana 代理程式和 Envoy Proxy 必須在相同的名稱空間中執行，且必須設定管理 IP 位址 127.0.0.1 。建議升級 Envoy Proxy 感應器。

檢視度量值

完成監視 Envoy Proxy 的配置區段中的配置步驟之後，您可以在 Instana 使用者介面中檢視與 Envoy Proxy 相關的度量值。

若要檢視度量值，請完成下列步驟:

在 Instana 使用者介面的資訊看板中，選取 基礎架構。
按一下特定的受監視主機。

然後，您可以查看包含所有已收集度量及受監視處理程序的主機儀表板。

Envoy Proxy 的分散式追蹤配置

若要使用 Envoy Proxy 的分散式追蹤，請完成下列步驟:

在 Envoy Distributed Tracing 二進位檔頁面中，下載 Envoy Proxy 受支援發行套件的 Instana 二進位檔。

下載追蹤程式二進位檔之後，請將它放置在可由 Envoy Proxy 讀取的位置，例如 /opt/envoy/libcxx-libinstana_sensor.so。然後，將 tracing 區段新增至 Envoy Proxy 的配置 YAML 檔，如下所示:

static_resources:
  listeners:
    - address:
      ...
      filter_chains:
        - filters:
            - name: envoy.filters.network.http_connection_manager
              typed_config:
                "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
                ...

使用 library 金鑰來配置追蹤程式二進位檔的路徑，並使用 service 金鑰來配置服務名稱，如下所示:

                tracing:
                  provider:
                    name: envoy.tracers.dynamic_ot
                    typed_config:
                      "@type": type.googleapis.com/envoy.config.trace.v3.DynamicOtConfig
                      library: /opt/envoy/libcxx-libinstana_sensor.so
                      config:
                        service: your-service-name

如需相關資訊，請參閱官方 Envoy Proxy 文件。

如需如何使用「分散式追蹤」，請參閱特使追蹤儲存庫頁面中的配置範例。

Envoy 追蹤範例

Instana 提供公用儲存庫，以預覽 Envoy Proxy 感應器的追蹤功能。如需相關資訊，請參閱特使追蹤。

疑難排解

監視問題類型: envoy_access_metrics_endpoint_failed

若要解決此問題，請依照管理介面文件中的說明來配置管理介面。

監視問題類型: envoy_missing_configuration_admin_address_path

若要解決此問題，請將 Instana 代理程式的 Envoy Proxy 感應器升級至最新版本。從 1.1.0版開始，支援儲存器化環境及 YAML 配置剖析。