使用範例建立指標和追蹤記錄的關聯

本文件說明示例，也就是附加至指標資料點的示例資料點。範例的用途之一是儲存追蹤記錄的連結，讓您將指標和追蹤記錄資料建立關聯。本文件也說明如何使用 OpenTelemetry 產生範例。

關於範例

您可以使用示例將任意資料與指標資料建立關聯。您可以使用這些資料附加非公制單位資料至測量資料。範例的用途之一，是將追蹤資料與指標資料建立關聯。在 Cloud Monitoring 中，您可以將範例附加至具有 Distribution 值類型的指標資料。分布值指標會收集許多評估資料，並將其分組為桶。每個「點」都是直方圖，也就是列出值區計數的陣列。系統不會保留實際的評估資料，只會保留值區計數。詳情請參閱「關於分佈值指標」。

寫入指標資料點時，可以將 Exemplar 物件陣列附加至該資料。使用範例時，會將實用資訊附加至指標資料。舉例來說，當 OpenTelemetry 寫入範例時，會附加連結至目前的追蹤範圍。

直方圖資料通常會以熱圖顯示。如果「點」包含範例，Cloud Monitoring 會在熱力圖上加上圓點註解：

  • 如要查看指標點的摘要資訊，請啟用註解的工具提示。
  • 如要存取追蹤記錄，請選取註解。

舉例來說，Go 檢測範例會使用 OpenTelemetry 寫入指標資料、追蹤資料和範例。下列螢幕截圖顯示應用程式執行多次後的 prometheus/http_server_duration_milliseconds/histogram 指標值：

顯示多個範例的熱圖範例。

上圖顯示多個範例。展開一個範例的工具提示，即可查看日期、追蹤記錄名稱、百分位數和延遲值。

選取註解後，系統會顯示在範例中連結的追蹤記錄：

範例追蹤記錄詳細資料。

如果顯示的資訊不夠詳細，您可以選取「View in Trace」，開啟「Trace Explorer」頁面。您可以在該頁面中查看追蹤記錄屬性，以及存取記錄項目的連結。

如何啟用 OpenTelemetry 範例

如上例所示，您可以設定 OpenTelemetry 來編寫範例，將追蹤記錄的目前 span 連結至指標測量值。不過，您必須完成下列操作，才能編寫範例：

  1. 設定 OpenTelemetry 指標和追蹤 SDK。

  2. 如要在自訂檢測元件中加入範例，請務必在區間內記錄指標，並透過指標測量傳遞區間的內容。

    例如，computeSubrequests 函式會遵循先前的指導方針。函式 subRequestsHistogram.Record 會在 tracer.Start 之後和 span.End 之前叫用，而 span.End 會延後。請注意，情境 ctx 會從 tracer.Start 傳遞至 Record 函式：

    func computeSubrequests(r *http.Request, subRequests int) error {
	// Add custom span representing the work done for the subrequests
	ctx, span := tracer.Start(r.Context(), "subrequests")
	defer span.End()

	// Make specified number of http requests to the /single endpoint.
	for i := 0; i < subRequests; i++ {
		if err := callSingle(ctx); err != nil {
			return err
		}
	}
	// record number of sub-requests made
	subRequestsHistogram.Record(ctx, int64(subRequests))
	return nil
}

    如要進一步瞭解這個範例，請參閱「在應用程式中新增自訂追蹤記錄和指標」。

後續步驟