監視 Google Cloud Pub/Sub

設定

Instana Google Cloud 整合使用服務帳戶，在 Google Cloud 與 Instana 之間建立 API 連線。 以下是建立服務帳戶及提供 Instana 服務帳戶認證以開始代表您進行 API 呼叫的指示。

  1. 導覽至您要設定 Instana 整合之 Google Cloud 專案的 Google Cloud 認證頁面 。
  2. 按 建立認證 ，然後選取 服務帳戶金鑰
    SelectService帳戶
  3. 在 服務帳戶 下拉清單中，選取 新建服務帳戶
  4. 為服務帳戶提供唯一名稱
  5. 選擇角色或建立至少包含下列許可權的自訂角色:
    • monitoring.timeSeries.list
    • pubsub.subscriptions.list
    • pubsub.topics.list
    • resourcemanager.projects.get
  6. 選取 JSON 作為金鑰類型，然後按建立
  7. 請記下此檔案的儲存位置，因為需要它才能完成整合
  8. 使用認證檔的路徑，將欄位新增至 configuration.yml credentials_path 。 (配置區段中的範例。)

為了監視專案，需要啟用下列服務:

配置

您可以將下列配置新增至「GCP 代理程式」的 配置檔 ，以配置 Google Cloud Pub/Sub 度量值輪詢率 (以秒為單位):

com.instana.plugin.gcp.pubsub:
  enabled: true
  poll_rate: 60  # How often Google's monitoring API will be polled
  credentials_path: '/opt/instana/credentials/cred-gcp.json'  # Path to Service Account credentials
  include_tags:
    topic:
    subscription:
  exclude_tags:
    topic:
    subscription:

過濾

可以定義多個標籤，以逗點區隔。 標籤應該提供為鍵值組，以: 字元區隔。 為了使配置更容易，可以定義您要在探索中併入或從探索中排除哪些標籤。 如果在兩個清單 (包括及排除) 中定義標籤，則排除清單具有較高的優先順序。 如果不需要過濾服務，則不應定義配置。 為了啟用過濾，不一定要定義所有值。

若要將主題及依標籤的訂閱併入探索中，請使用下列配置:

com.instana.plugin.gcp.pubsub:
  include_tags:
    topic: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
    subscription: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

若要從探索中排除依標籤列出的主題和訂閱，請使用下列配置:

com.instana.plugin.gcp.pubsub:
  exclude_tags: 
    topic: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
    subscription: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

如果包含標籤配置應該同時套用至主題和訂閱，請使用下列配置:

com.instana.plugin.gcp.pubsub:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

如果排除標籤配置應該同時套用至主題和訂閱，請使用下列配置:

com.instana.plugin.gcp.pubsub:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Google Cloud Pub/Sub -度量值集合

配置資料

  • 專案名稱
  • 專案 ID
  • 專案號碼
  • 建立時間

效能度量

度量 說明 縮減器/對齊器
訊息計數 Cloud Pub/Sub 傳送至訂閱者用戶端的訊息累加計數。 REDUCE_SUM/ALIGN_DELTA
訊息大小 訂閱中未認可訊息的位元組大小總計。 REDUCE_SUM/ALIGN_MEAN
最舊訊息的經歷時間 訂閱中最舊未確認訊息的經歷時間 (秒)。 REDUCE_MAX/ALIGN_MEAN

所有度量的精度為 60 秒。

Google Cloud Pub/Sub 主題-度量值集合

配置資料

  • 專案 ID
  • 主題名稱

效能度量

度量 說明 縮減器/對齊器
訊息大小 訂閱中未認可訊息的位元組大小總計。 REDUCE_MEAN/ALIGN_DELTA
已壓縮的最舊訊息經歷時間 主題中保留的最舊已確認訊息的經歷時間 (以秒為單位) ，依雲端區域細分。 REDUCE_SUM/ALIGN_MEAN
未壓縮的最舊訊息經歷時間 主題中最舊未確認訊息的經歷時間 (以秒為單位) ，依雲端區域細分。 REDUCE_SUM/ALIGN_MEAN
發佈作業 發佈訊息作業的累加計數，依結果分組。 REDUCE_SUM/ALIGN_DELTA
發佈要求 發佈要求的累加計數，依結果分組。 REDUCE_SUM/ALIGN_DELTA
營運成本 作業成本 (以位元組為單位測量)。 REDUCE_SUM/ALIGN_DELTA

精度是所有度量值的 60 秒。

Google Cloud Pub/Sub 訂閱-度量值集合

配置資料

  • 專案 ID
  • 訂閱名稱
  • 主題名稱

效能度量

度量 說明 縮減器/對齊器
訊息大小 訂閱中未認可訊息的位元組大小總計。 REDUCE_NONE/ALIGN_MEAN
已壓縮的訊息數 「確認」要求所確認的訊息累加計數。 REDUCE_SUM/ALIGN_DELTA
未壓縮的訊息數 訂閱中未確認的訊息數。 REDUCE_NONE/ALIGN_MEAN
無法傳送的郵件 發佈至無法傳送的郵件主題的訊息累加計數。 REDUCE_SUM/ALIGN_DELTA
已傳送的訊息 Cloud Pub/Sub 傳送至訂閱者用戶端的訊息累加計數。 REDUCE_SUM/ALIGN_DELTA
未完成的訊息數 遞送至訂閱推送端點但尚未確認的訊息數。 REDUCE_NONE/ALIGN_MEAN
已壓縮的最舊訊息經歷時間 在訂閱中保留的最舊已確認訊息的經歷時間 (以秒為單位)。 REDUCE_NONE/ALIGN_MEAN
未壓縮的最舊訊息經歷時間 訂閱中最舊未確認訊息的經歷時間 (秒)。 REDUCE_NONE/ALIGN_MEAN
訊息作業取回 依結果分組的取回訊息作業累加計數。 REDUCE_SUM/ALIGN_DELTA
訊息作業確認 確認訊息作業的累加計數，依結果分組。 REDUCE_SUM/ALIGN_DELTA
要求取回 取回要求的累加計數，依結果分組。 REDUCE_SUM/ALIGN_DELTA
要求推送 按結果分組的推送嘗試累加計數。 REDUCE_SUM/ALIGN_DELTA
要求確認 確認要求的累加計數，依結果分組。 REDUCE_SUM/ALIGN_DELTA
要求推送延遲 推送要求延遲的配送 (以微秒為單位) ，依結果分組。 REDUCE_MEAN/ALIGN_DELTA
配置更新計數 每一個訂閱的配置變更累加計數。 REDUCE_SUM/ALIGN_DELTA
營運成本 累積作業成本 (以位元組為單位測量)。 REDUCE_SUM/ALIGN_DELTA

精度是所有度量值的 60 秒。

性能簽章

對於每一個感應器，都有一個經過策劃的性能簽章知識庫，可針對送入的度量值持續進行評估，並用來根據使用者影響來提出問題或發生事件。

內建事件 會根據實體上失敗的性能簽章來觸發問題或突發事件，而 自訂事件 會根據任何給定實體個別度量的已定義臨界值來觸發問題或突發事件。

如需 Google Cloud Pub/Sub建置事件的相關資訊，請參閱 內建事件參照。