使用 AWS Distro for OpenTelemetry (ADOT) SDK 匯出無收集器遙測 - Amazon CloudWatch

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 AWS Distro for OpenTelemetry (ADOT) SDK 匯出無收集器遙測

您可以使用 ADOT SDKs進行無收集,並將追蹤和日誌直接傳送到 OTLP 端點。

注意

Application Signals 包含交易搜尋功能。若要避免重複成本,請在 ADOT 開發套件中停用 Application Signals,並保持OTEL_AWS_APPLICATION_SIGNALS_ENABLED設定為 false (預設設定)。

先決條件

確定交易搜尋已啟用,以傳送跨度至 X-Ray OTLP 端點。如需詳細資訊,請參閱交易搜尋入門

為您的角色設定 IAM 許可

請依照下列步驟,將必要的 IAM 政策連接至您的角色:

追蹤:

  1. 前往 https://console.aws.amazon.com/iam/ 開啟 IAM 主控台。

  2. 選擇角色,然後尋找並選取您設定的角色。

  3. 許可索引標籤下,選擇新增許可,然後選擇連接政策

  4. 使用搜尋方塊,搜尋 AWSXrayWriteOnlyPolicy

  5. 選取AWSXrayWriteOnlyPolicy政策,然後選擇新增許可

日誌:

  1. 前往 https://console.aws.amazon.com/iam/ 開啟 IAM 主控台。

  2. 選擇角色,然後尋找並選取您設定的角色。

  3. 許可索引標籤下,選擇新增許可,然後選擇建立內嵌政策

  4. 選取服務的 CloudWatch Logs,然後在允許的動作下,篩選並選取:

    logs:PutLogEvents logs:DescribeLogGroups logs:DescribeLogStreams
  5. 以下是授予所需許可的 IAM 政策範例:

    { "Version": "2012-10-17", "Statement": [ { "Sid": "CloudWatchLogsAccess", "Effect": "Allow", "Action": [ "logs:PutLogEvents", "logs:DescribeLogGroups", "logs:DescribeLogStreams" ], "Resource": [ "arn:aws:logs:*:*:log-group:*" ] } ] }

設定您的登入資料提供者

ADOT 使用 AWS SDKs自動探索匯出遙測資料所需的有效登入資料 AWS。如需為特定環境設定登入資料的指引,請參閱 AWS SDKS 如何擷取登入資料的文件。

設定現場部署主機的 IAM 登入資料:

輸入下列命令,在現場部署主機中設定您的 AWS 登入資料。SECRET_ACCESS_KEYACCESS_KEY_ID和 取代為您設定的 IAM 角色或使用者的登入資料。

$ aws configure AWS Access Key ID [None]: ACCESS_KEY_ID AWS Secret Access Key [None]: SECRET_ACCESS_ID Default region name [None]: MY_REGION Default output format [None]: json

啟用 ADOT SDKs

您可以從 Java、Node.js、Python 和 .Net 上的 AWS Distro for OpenTelemetry (ADOT) 開發套件,讓應用程式日誌和追蹤直接傳送到 OTLP 端點。

Java
注意

您必須使用 ADOT Java Agent 2.11.2 版或更新版本,才能使用這些功能。

  1. 下載最新版本的 AWS Distro for OpenTelemetry Java 自動檢測代理程式。您可以使用此命令下載最新版本:

    curl -L -O https://github.com/aws-observability/aws-otel-java-instrumentation/releases/latest/download/aws-opentelemetry-agent.jar

    可以透過 aws-otel-java-instrumentation 發行版本檢視所有已發行的版本資訊。

  2. 若要啟用直接將遙測傳送至 OTLP 端點的不同匯出工具,並最佳化優點,請在啟動應用程式之前使用下列環境變數:

    追蹤:

    • 設定 OTEL_EXPORTER_OTLP_TRACES_ENDPOINT以指定 X-Ray OTLP 追蹤端點: https://xray.[AWSRegion].amazonaws.com/v1/traces

      例如:

      export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://xray.us-west-2.amazonaws.com/v1/traces"
    • OTEL_TRACES_EXPORTER 設定為 otlp(這是選用的,如果未設定此環境變數,則為預設值)。

    • OTEL_EXPORTER_OTLP_TRACES_PROTOCOL變數設定為 http/protobuf(這是選用的,如果未設定此環境變數,則預設值為 )。

    • 設定OTEL_RESOURCE_ATTRIBUTES變數,將下列資訊指定為鍵/值對。Application Signals 會使用這些環境變數,並轉換為 X-Ray 追蹤註釋和 CloudWatch 指標維度。

      • (選用) service.name設定服務的名稱。這會在 Application Signals 儀表板中顯示為您的應用程式的服務名稱。如果您不提供此索引鍵的值,則會使用預設值 UnknownService

      • (選用) deployment.environment設定應用程式執行所在的環境。這會顯示為您應用程式的託管環境

      • (選用) 若要啟用日誌相互關聯,請在 aws.log.group.namesOTEL_RESOURCE_ATTRIBUTES為應用程式的日誌群組設定額外的環境變數。如此一來,您應用程式的追蹤和指標就可以與這些日誌群組的相關日誌項目建立關聯。針對此變數,請將 $YOUR_APPLICATION_LOG_GROUP取代為應用程式的日誌群組名稱。如果您有多個日誌群組,您可以使用 ampersand (&) 來分隔它們,如本範例所示:aws.log.group.names=log-group-1&log-group-2。若要啟用指標來記錄相互關聯,設定此目前環境變數就已足夠。如需詳細資訊,請參閱啟用指標以記錄相互關聯。若要啟用追蹤以記錄相互關聯,您還需要變更應用程式中的記錄組態。如需詳細資訊,請參閱啟用追蹤以記錄相互關聯

    日誌:

    • 設定 OTEL_EXPORTER_OTLP_LOGS_ENDPOINT以指定 CloudWatch OTLP 日誌端點: https://logs.[AWSRegion].amazonaws.com/v1/logs

      例如:

      export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://logs.us-west-2.amazonaws.com/v1/logs"
    • 設定 OTEL_EXPORTER_OTLP_LOGS_HEADERS以指定您要匯出日誌的日誌群組和日誌串流 (注意:這些必須在執行 ADOT 之前建立): x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]

      例如:

      export OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default
    • OTEL_LOGS_EXPORTER 設定為 otlp(這是選用的,如果未設定此環境變數,則為預設值)。

    • OTEL_EXPORTER_OTLP_LOGS_PROTOCOL變數設定為 http/protobuf(這是選用的,如果未設定此環境變數,則預設值為 )。

  3. 設定 JAVA_TOOL_OPTIONS以指定 AWS 存放 Distro for OpenTelemetry Java 自動檢測代理程式的路徑。例如:

    export JAVA_TOOL_OPTIONS=" -javaagent:$AWS_ADOT_JAVA_INSTRUMENTATION_PATH" export AWS_ADOT_JAVA_INSTRUMENTATION_PATH="./aws-opentelemetry-agent.jar"
  4. 您的應用程式現在應該使用 ADOT Java 檢測執行,並會產生跨度和日誌。範圍會存放在 aws/spans CloudWatch 日誌群組中,而日誌則會存放在 OTEL_EXPORTER_OTLP_LOGS_HEADERS標頭中指定的日誌群組中。您也可以在 CloudWatch Traces and Metrics 主控台中檢視與您的範圍相關的日誌和指標。

  5. 使用上一個步驟中列出的環境變數啟動應用程式。以下是啟動指令碼的範例。

    JAVA_TOOL_OPTIONS=" -javaagent:$AWS_ADOT_JAVA_INSTRUMENTATION_PATH" \ OTEL_METRICS_EXPORTER=none \ OTEL_TRACES_EXPORTER=otlp \ OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf \ OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://xray.us-east-1.amazonaws.com/v1/traces \ OTEL_LOGS_EXPORTER=otlp \ OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=http/protobuf \ OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://logs.us-east-1.amazonaws.com/v1/logs \ OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default OTEL_RESOURCE_ATTRIBUTES="service.name=$YOUR_SVC_NAME" \ java -jar $MY_JAVA_APP.jar
Node.js
注意

您必須使用 ADOT JavaScript 0.7.0 版或更新版本,才能使用這些功能。

  1. 下載最新版本的 AWS Distro for OpenTelemetry JavaScript 自動檢測。請執行下列 命令進行安裝。

    npm install @aws/aws-distro-opentelemetry-node-autoinstrumentation

    您可以在 aws-otel-js-instrumentation Releases 中檢視所有發行版本的相關資訊。

  2. 若要啟用直接將遙測傳送至 OTLP 端點的不同匯出工具,並最佳化優點,請在啟動應用程式之前使用下列環境變數:

    追蹤:

    • 設定 OTEL_EXPORTER_OTLP_TRACES_ENDPOINT以指定 X-Ray OTLP 追蹤端點: https://xray.[AWSRegion].amazonaws.com/v1/traces

      例如:

      export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://xray.us-west-2.amazonaws.com/v1/traces"
    • OTEL_TRACES_EXPORTER 設定為 otlp(這是選用的,如果未設定此環境變數,則為預設值)。

    • OTEL_EXPORTER_OTLP_TRACES_PROTOCOL變數設定為 http/protobuf(這是選用的,如果未設定此環境變數,則預設值為 )。

    • 設定OTEL_RESOURCE_ATTRIBUTES變數,將下列資訊指定為鍵/值對。Application Signals 會使用這些環境變數,並轉換為 X-Ray 追蹤註釋和 CloudWatch 指標維度。

      • (選用) service.name設定服務的名稱。這會在 Application Signals 儀表板中顯示為您的應用程式的服務名稱。如果您不提供此索引鍵的值,則會使用預設值 UnknownService

      • (選用) deployment.environment設定應用程式執行所在的環境。這將顯示為您應用程式的託管環境

      • (選用) 若要啟用日誌相互關聯,請在 aws.log.group.namesOTEL_RESOURCE_ATTRIBUTES為應用程式的日誌群組設定額外的環境變數。如此一來,您應用程式的追蹤和指標就可以與這些日誌群組的相關日誌項目建立關聯。針對此變數,請將 $YOUR_APPLICATION_LOG_GROUP取代為應用程式的日誌群組名稱。如果您有多個日誌群組,您可以使用 ampersand (&) 來分隔它們,如本範例所示:aws.log.group.names=log-group-1&log-group-2。若要啟用指標來記錄相互關聯,設定此目前環境變數就已足夠。如需詳細資訊,請參閱啟用指標以記錄相互關聯。若要啟用追蹤以記錄相互關聯,您還需要變更應用程式中的記錄組態。如需詳細資訊,請參閱啟用追蹤以記錄相互關聯

    日誌:

    • 設定 OTEL_EXPORTER_OTLP_LOGS_ENDPOINT以指定 CloudWatch OTLP 日誌端點: https://logs.[AWSRegion].amazonaws.com/v1/logs

      例如:

      export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://logs.us-west-2.amazonaws.com/v1/logs"
    • 設定 OTEL_EXPORTER_OTLP_LOGS_HEADERS以指定您要匯出日誌的日誌群組和日誌串流 (注意:這些必須在執行 ADOT 之前建立): x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]

      例如:

      export OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default
    • OTEL_LOGS_EXPORTER 設定為 otlp(這是選用的,如果未設定此環境變數,則為預設值)。

    • OTEL_EXPORTER_OTLP_LOGS_PROTOCOL變數設定為 http/protobuf(這是選用的,如果未設定此環境變數,則預設值為 )。

  3. 您的應用程式現在應該使用 ADOT JavaScript 檢測執行,並會產生跨度和日誌。範圍會存放在 aws/spans CloudWatch 日誌群組中,而日誌則會存放在 OTEL_EXPORTER_OTLP_LOGS_HEADERS標頭中指定的日誌群組中。您也可以在 CloudWatch Traces and Metrics 主控台中檢視與您的範圍相關的日誌和指標。

  4. 使用上一個步驟中列出的環境變數啟動應用程式。以下是啟動指令碼的範例。

    $SVC_NAME 取代為應用程式名稱。這會顯示為應用程式的名稱。

    OTEL_METRICS_EXPORTER=none \ OTEL_TRACES_EXPORTER=otlp \ OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf \ OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://xray.us-east-1.amazonaws.com/v1/traces \ OTEL_LOGS_EXPORTER=otlp \ OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=http/protobuf \ OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://logs.us-east-1.amazonaws.com/v1/logs \ OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default OTEL_RESOURCE_ATTRIBUTES="service.name=$YOUR_SVC_NAME" \ node --require '@aws/aws-distro-opentelemetry-node-autoinstrumentation/register' your-application.js
Python
注意

您必須使用 ADOT Python 0.10.0 版或更新版本,botocore已安裝這些功能才能使用。

  1. 下載最新版本的 AWS Distro for OpenTelemetry Python 自動檢測。請執行下列 命令進行安裝。

    pip install aws-opentelemetry-distro

    您可以在 aws-otel-python-instrumentation Releases 中檢視所有發行版本的相關資訊。

  2. 若要啟用直接將遙測傳送至 OTLP 端點的不同匯出工具,並最佳化優點,請在啟動應用程式之前使用下列環境變數:

    對於追蹤和日誌組態,您必須設定下列環境變數:

    • OTEL_PYTHON_DISTROaws_distro

    • OTEL_PYTHON_CONFIGURATORaws_configurator

    追蹤:

    • 設定 OTEL_EXPORTER_OTLP_TRACES_ENDPOINT以指定 X-Ray OTLP 追蹤端點: https://xray.[AWSRegion].amazonaws.com/v1/traces

      例如:

      export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://xray.us-west-2.amazonaws.com/v1/traces"
    • OTEL_TRACES_EXPORTER 設定為 otlp(這是選用的,如果未設定此環境變數,則為預設值)。

    • OTEL_EXPORTER_OTLP_TRACES_PROTOCOL變數設定為 http/protobuf(這是選用的,如果未設定此環境變數,則預設值為 )。

    • 設定OTEL_RESOURCE_ATTRIBUTES變數,將下列資訊指定為鍵/值對。Application Signals 會使用這些環境變數,並轉換為 X-Ray 追蹤註釋和 CloudWatch 指標維度。

      • (選用) service.name設定服務的名稱。這會在 Application Signals 儀表板中顯示為您的應用程式的服務名稱。如果您不提供此索引鍵的值,則會使用預設值 UnknownService

      • (選用) deployment.environment設定應用程式執行所在的環境。這將顯示為您應用程式的託管環境

      • (選用) 若要啟用日誌相互關聯,請在 aws.log.group.namesOTEL_RESOURCE_ATTRIBUTES為應用程式的日誌群組設定額外的環境變數。如此一來,您應用程式的追蹤和指標就可以與這些日誌群組的相關日誌項目建立關聯。針對此變數,請將 $YOUR_APPLICATION_LOG_GROUP取代為應用程式的日誌群組名稱。如果您有多個日誌群組,您可以使用 ampersand (&) 來分隔它們,如本範例所示:aws.log.group.names=log-group-1&log-group-2。若要啟用指標來記錄相互關聯,設定此目前環境變數就已足夠。如需詳細資訊,請參閱啟用指標以記錄相互關聯。若要啟用追蹤以記錄相互關聯,您還需要變更應用程式中的記錄組態。如需詳細資訊,請參閱啟用追蹤以記錄相互關聯

    日誌:

    • OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED 設定為 true

    • 設定 OTEL_EXPORTER_OTLP_LOGS_ENDPOINT以指定 CloudWatch OTLP 日誌端點: https://logs.[AWSRegion].amazonaws.com/v1/logs

      例如:

      export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://logs.us-west-2.amazonaws.com/v1/logs"
    • 設定 OTEL_EXPORTER_OTLP_LOGS_HEADERS以指定您要匯出日誌的日誌群組和日誌串流 (注意:這些必須在執行 ADOT 之前建立): x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]

      例如:

      export OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default
    • OTEL_LOGS_EXPORTER 設定為 otlp(這是選用的,如果未設定此環境變數,則為預設值)。

    • OTEL_EXPORTER_OTLP_LOGS_PROTOCOL變數設定為 http/protobuf(這是選用的,如果未設定此環境變數,則預設值為 )。

  3. 您的應用程式現在應該使用 ADOT Python 檢測執行,並會產生跨度和日誌。範圍會存放在 aws/spans CloudWatch 日誌群組中,而日誌則會存放在 OTEL_EXPORTER_OTLP_LOGS_HEADERS標頭中指定的日誌群組中。您也可以在 CloudWatch Traces and Metrics 主控台中檢視與您的範圍相關的日誌和指標。

  4. 使用上一個步驟中列出的環境變數啟動應用程式。以下是啟動指令碼的範例。

    $SVC_NAME 取代為應用程式名稱。這會顯示為應用程式的名稱。

    $PYTHON_APP 將 取代為您應用程式的位置和名稱。

    OTEL_METRICS_EXPORTER=none \ OTEL_TRACES_EXPORTER=otlp \ OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf \ OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://xray.us-east-1.amazonaws.com/v1/traces \ OTEL_LOGS_EXPORTER=otlp \ OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=http/protobuf \ OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://logs.us-east-1.amazonaws.com/v1/logs \ OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true OTEL_RESOURCE_ATTRIBUTES="service.name=$YOUR_SVC_NAME" \ opentelemetry-instrument python $MY_PYTHON_APP.py
.Net
注意
  • 這些功能需要 ADOT .NET 1.8.0 版或更新版本才能使用。

  • 目前不支援壓縮。

  • 目前不支援日誌。

下載最新版本的 AWS Distro for OpenTelemetry .NET 自動檢測套件。您可以在 aws-otel-dotnet-instrumentation Releases 中檢視所有發行版本的相關資訊。

若要啟用直接將遙測傳送至 OTLP 端點的不同匯出工具,並最佳化優點,請在啟動應用程式之前使用以下環境變數 (以您選擇的服務名稱dotnet-service-name取代OTEL_RESOURCE_ATTRIBUTES環境變數):

追蹤:

  • 您必須OTEL_TRACES_EXPORTER將 設定為 none

  • 您必須OTEL_AWS_SIG_V4_ENABLED將 設定為 true

    此功能不會在 .NET 中自動啟用。在 .NET 檢測中,特別需要 環境變數來識別此使用案例。此要求對 .NET 而言是唯一的,不適用於其他支援的語言

以下是 Linux 的範例設定。

export INSTALL_DIR=OpenTelemetryDistribution export CORECLR_ENABLE_PROFILING=1 export CORECLR_PROFILER={918728DD-259F-4A6A-AC2B-B85E1B658318} export CORECLR_PROFILER_PATH=${INSTALL_DIR}/linux-x64/OpenTelemetry.AutoInstrumentation.Native.so export DOTNET_ADDITIONAL_DEPS=${INSTALL_DIR}/AdditionalDeps export DOTNET_SHARED_STORE=${INSTALL_DIR}/store export DOTNET_STARTUP_HOOKS=${INSTALL_DIR}/net/OpenTelemetry.AutoInstrumentation.StartupHook.dll export OTEL_DOTNET_AUTO_HOME=${INSTALL_DIR} export OTEL_DOTNET_AUTO_PLUGINS="AWS.Distro.OpenTelemetry.AutoInstrumentation.Plugin, AWS.Distro.OpenTelemetry.AutoInstrumentation" export OTEL_TRACES_EXPORTER=none export OTEL_AWS_SIG_V4_ENABLED=true export OTEL_RESOURCE_ATTRIBUTES=service.name=dotnet-service-name export OTEL_METRICS_EXPORTER=none export OTEL_LOGS_EXPORTER=none export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://xray.us-east-1.amazonaws.com/v1/traces

以下是 Windows Server 的範例設定:

$env:INSTALL_DIR = "OpenTelemetryDistribution" $env:CORECLR_ENABLE_PROFILING = 1 $env:CORECLR_PROFILER = "{918728DD-259F-4A6A-AC2B-B85E1B658318}" $env:CORECLR_PROFILER_PATH = Join-Path $env:INSTALL_DIR "win-x64/OpenTelemetry.AutoInstrumentation.Native.dll" $env:DOTNET_ADDITIONAL_DEPS = Join-Path $env:INSTALL_DIR "AdditionalDeps" $env:DOTNET_SHARED_STORE = Join-Path $env:INSTALL_DIR "store" $env:DOTNET_STARTUP_HOOKS = Join-Path $env:INSTALL_DIR "net/OpenTelemetry.AutoInstrumentation.StartupHook.dll" $env:OTEL_DOTNET_AUTO_HOME = $env:INSTALL_DIR $env:OTEL_DOTNET_AUTO_PLUGINS = "AWS.Distro.OpenTelemetry.AutoInstrumentation.Plugin, AWS.Distro.OpenTelemetry.AutoInstrumentation" $env:OTEL_TRACES_EXPORTER=none $env:OTEL_AWS_SIG_V4_ENABLED=true $env:OTEL_RESOURCE_ATTRIBUTES=service.name=dotnet-service-name $env:OTEL_METRICS_EXPORTER=none $env:OTEL_LOGS_EXPORTER=none $env:OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf $env:OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://xray.us-east-1.amazonaws.com/v1/traces
  1. 使用上一個步驟中列出的環境變數啟動應用程式。

  2. (選用) 或者,您可以使用提供的安裝指令碼來協助安裝和設定 AWS Distro for OpenTelemetry .NET 自動檢測套件。

    針對 Linux,請從 GitHub 版本頁面下載並安裝 Bash 安裝指令碼:

    # Download and Install curl -L -O https://github.com/aws-observability/aws-otel-dotnet-instrumentation/releases/latest/download/aws-otel-dotnet-install.sh chmod +x ./aws-otel-dotnet-install.sh ./aws-otel-dotnet-install.sh # Instrument . $HOME/.otel-dotnet-auto/instrument.shexport OTEL_RESOURCE_ATTRIBUTES=service.name=dotnet-service-name

    對於 Windows Server,請從 GitHub 版本頁面下載並安裝 PowerShell 安裝指令碼:

    # Download and Install $module_url = "https://github.com/aws-observability/aws-otel-dotnet-instrumentation/releases/latest/download/AWS.Otel.DotNet.Auto.psm1" $download_path = Join-Path $env:temp "AWS.Otel.DotNet.Auto.psm1" Invoke-WebRequest -Uri $module_url -OutFile $download_path Import-Module $download_path Install-OpenTelemetryCore # Instrument Import-Module $download_path Register-OpenTelemetryForCurrentSession -OTelServiceName "dotnet-service-name" Register-OpenTelemetryForIIS

    您可以在官方 NuGet 儲存庫中找到 AWS Distro for OpenTelemetry .NET 自動檢測套件的 NuGet 套件。 NuGet 請務必檢查 README 檔案以取得指示。