服務

建立自訂服務規則

1. 從資訊看板中，按一下 應用程式 ，然後選取 服務 標籤。
2. 按一下 配置服務
3. 按一下 新增自訂服務規則
4. 從下拉清單中，選取標籤。

使用自訂服務規則的一個原因是使用基礎架構元件的現有 meta 資訊。 例如，如果您使用網域特定資訊 (例如 com.acme.service-name:myservice) 來標示 Docker 儲存器，以從此標籤對映服務，請選取 docker.label 及 com.acme.service-name 標籤。 傳遞具有標籤 com.acme.service-name 之儲存器的所有呼叫都會與服務相關聯，該服務由該值命名，例如 myservice。 有多個標籤可用來建立自訂服務對映。

您也可以為服務對映新增多個索引鍵。 多個標籤以橫線連接。 請注意，所有金鑰都需要相符，例如，如果您要根據主機區域來區隔暫置服務，則可以新增兩個金鑰: host.zone + docker.label:com.acme.service-name。 然後，您的服務會以主機區域值的連結命名，後面接著 Docker 標籤。 這樣您就可以區隔出兩個服務，例如 prod-myservice 和 dev-myservice。

透過使用特殊標籤 service.default_name，也可以使用自訂服務規則來延伸具有更多標籤的服務預設規則。 例如，若要依主機區域分割自動建立的服務，請使用標籤 service.default_name 和 host.zone來建立自訂服務規則。

套用呼叫標籤 service.name

若要建立特定呼叫的關聯，請註釋呼叫，這會在程式碼內啟用自訂對映。 為了搜尋及分析呼叫， service 註釋會變成 service.name 標籤。

若要新增呼叫註釋，可以使用下列選項:

• JavaSDK: https://github.com/instana/instana-java-sdk (SpanSupport.annotate).

• OpenTracing Java: https://github.com/instana/instana-java-opentracing (span.setTag)。

• Python: https://github.com/instana/python-sensor (span.set_tag).

• Ruby: https://github.com/instana/ruby-sensor (span.set_tag)。

• PHP: https://github.com/instana/instana-php-opentracing (\$span->setTag)。

• 執行: https://github.com/instana/go-sensor/ (span.SetTag)。

• Node.js: 請參閱 Node.js 配置文件 (程序層面的配置，不支援提供不同呼叫的個別名稱)。

• Haskell: http://hackage.haskell.org/package/instana-haskell-trace-sdk (InstanaSDK.setServiceName)。

如需 Java 追蹤 SDK 及服務命名的相關資訊，請參閱 轉換及命名 小節。

指定 INSTANA_SERVICE_NAME 環境變數

透過在處理程序上設定 INSTANA_SERVICE_NAME 環境變數，環境變數的值會用作作為該處理程序目的地之所有呼叫的服務名稱。

如需 Instana 所辨識之環境變數的相關資訊，請參閱 一般參照文件。

指定 X-Instana-Service HTTP 標頭

透過在呼叫上設定 X-Instana-Service HTTP 標頭，目的地 (接收 HTTP 要求的服務) 會以標頭中提供的值來標示。

附註: 不會自動收集 X-Instana-Service HTTP 標頭。 若要讓它運作，必須配置 Instana 代理程式，請參閱 「擷取自訂 HTTP 標頭」。

對映至具有自訂名稱的未受監視服務

對未受 Instana 監視之服務的呼叫，會使用呼叫標籤來對映至服務。

例如，對協力廠商 API (例如 www.google.com ) 的 HTTP 呼叫會根據 HTTP host 標頭 (call.http.host 標籤) 對映至服務 www.google.com 。 對 www.google.fr 或 www.google.de 的呼叫會對映至不同的服務，因為 HTTP host 標頭不同。

您可以新增下列手動服務配置，將不同網域的所有呼叫對映至名為 "Google" 的服務:

{
    "tagFilterExpression": {
        "type": "TAG_FILTER",
        "name": "call.http.host",
        "value": "www.google.",
        "operator": "STARTS_WITH",
        "entity": "NOT_APPLICABLE"
    },
    "unmonitoredServiceName": "Google",
    "description": "Map calls to different google domains to Google service",
    "enabled": true
}

從受監視基礎架構實體建立之現有資料庫或傳訊服務的鏈結呼叫

如果 Instana 監視資料庫或傳訊系統，則該資料庫或傳訊系統的呼叫應該根據基礎架構標籤 (例如 MySQL@3306 on demo-host) 對映至服務。 感謝 基礎架構相關性。 但有時由於存在 Proxy 或負載平衡器，基礎架構相關性可能無法運作，因為 Instana 不會監視或檢測該元件，且不知道如何遞送要求。 因此，會根據呼叫標籤將呼叫對映至服務 (例如 call.database.schema， call.database.connection 或 call.messaging.address) ，就像未監視目的地服務一樣。

在此情況下，您會發現從基礎架構實體建立的另一個服務沒有呼叫。 您可以使用下列手動服務配置，將呼叫對映至該現有服務:

{
    "tagFilterExpression": {
        "type": "TAG_FILTER",
        "name": "call.database.connection",
        "value": "jdbc:mysql://10.128.0.1:3306",
        "operator": "CONTAINS",
        "entity": "NOT_APPLICABLE"
    },
    "existingServiceId": "a880d1875389b78b49b19387ef7ab815b313764f", // service id of "MySQL@3306 on demo-host" service, can be found in the "serviceId" url parameter of the service dashboard
    "description": "Link calls to MySQL@3306 on demo-host service",
    "enabled": true
}

為何我看不到任何列出的服務?

未列出任何服務的原因是代理程式未在 APM 模式下執行，未安裝任何代理程式; 因此未收集任何追蹤資料，或者如果您已安裝代理程式，則在您選取的時間範圍內未收集追蹤資料。

若要檢查代理程式是否已安裝且在執行中，請按一下 基礎架構 以檢視基礎架構對映上可能具有代理程式的任何主機，或按一下 其他 > 代理程式 以查看已安裝代理程式的清單。 如果未列出任何代理程式，請參閱有關如何安裝 代理程式 或建立 應用程式視景的說明文件。

為何服務名稱有時會變更?

服務對映依賴基礎架構資料。 不過，在某些情況下，無法使用基礎架構資料來強化追蹤資料。 例如，在 Instana 代理程式或受監視程序啟動之後不久，可能不會強化追蹤資料。 在受監視應用程式完全檢測之前，以及在追蹤程式和感應器開始收集資料之前，需要一些時間。 如果在所有感應器變成作用中之前收集前幾個追蹤資料，則這些追蹤資料可能遺漏部分或甚至所有基礎架構資料。 在這種情況下，使用的服務名稱不太具體; 例如， HTTP 主機，而不是 SpringBoot 應用程式名稱。

稱為回復對映的機制用來避免與 Instana 代理程式或受監視程序重新啟動相關的服務對映問題。 如果對正確服務進行對映呼叫的基礎架構資料無法使用，則備援對映會生效。 具復原力的對映可以使用先前對映結果的快取，將呼叫指派給正確的服務。 不過，這可能會導致非預期的服務名稱，例如，如果快取包含過時的基礎架構資料。 當回復快取更新時，預期的服務會自動回復。