Prasyarat Siapkan izin IAM untuk peran Anda Konfigurasikan penyedia kredensional Anda Mengaktifkan ADOT SDKs

Mengekspor telemetri tanpa kolektor menggunakan AWS Distro for (ADOT) SDK OpenTelemetry

Anda dapat menggunakan ADOT SDKs untuk mengurangi kolektor dan mengirim jejak dan log langsung ke titik akhir OTLP.

catatan

Sinyal Aplikasi mencakup kemampuan Pencarian Transaksi. Untuk menghindari biaya duplikat, nonaktifkan Sinyal Aplikasi di SDK ADOT dan OTEL_AWS_APPLICATION_SIGNALS_ENABLED tetapkan ke false (pengaturan default).

Topik

Prasyarat
Siapkan izin IAM untuk peran Anda
Konfigurasikan penyedia kredensional Anda
Mengaktifkan ADOT SDKs

Prasyarat

Pastikan Transaction Search diaktifkan untuk mengirim rentang ke endpoint X-Ray OTLP. Untuk informasi selengkapnya, lihat Memulai Penelusuran Transaksi.

Siapkan izin IAM untuk peran Anda

Ikuti langkah-langkah ini untuk melampirkan kebijakan IAM yang diperlukan untuk peran Anda:

Jejak:

Buka konsol IAM di https://console.aws.amazon.com/iam/.
Pilih Peran dan temukan dan pilih peran yang dikonfigurasi.
Di bawah tab Izin, pilih Tambahkan izin, lalu Lampirkan kebijakan.
Menggunakan kotak pencarian, cariAWSXrayWriteOnlyPolicy.
Pilih AWSXrayWriteOnlyPolicy kebijakan dan pilih Tambahkan izin.

Log:

Buka konsol IAM di https://console.aws.amazon.com/iam/.
Pilih Peran dan temukan dan pilih peran yang dikonfigurasi.
Di bawah tab Izin, pilih Tambahkan izin, lalu Buat kebijakan sebaris.
Pilih CloudWatch Log untuk layanan dan di bawah Tindakan yang diizinkan, filter dan pilih:
```
logs:PutLogEvents
logs:DescribeLogGroups
logs:DescribeLogStreams
```

Berikut ini adalah contoh kebijakan IAM yang memberikan izin yang diperlukan:


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

Konfigurasikan penyedia kredensional Anda

ADOT menggunakan AWS SDKs untuk secara otomatis menemukan kredensil valid yang diperlukan untuk mengekspor data telemetri Anda. AWS Untuk panduan tentang mengonfigurasi kredensil untuk lingkungan spesifik Anda, lihat dokumentasi tentang cara AWS SDKS mengambil kredensil.

Menyiapkan kredensil IAM untuk host di lokasi:

Konfigurasikan AWS kredensional Anda di host lokal Anda dengan memasukkan perintah berikut. Ganti ACCESS_KEY_ID dan SECRET_ACCESS_KEY dengan kredensil untuk peran IAM atau pengguna Anda yang dikonfigurasi.


$ 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

Mengaktifkan ADOT SDKs

Anda dapat mengaktifkan log dan jejak agar aplikasi Anda dikirim langsung ke titik akhir OTLP dari AWS Distro for OpenTelemetry (ADOT) SDK di Java, Node.js, Python, dan .Net.

Java

catatan

Anda harus menggunakan ADOT Java Agent versi 2.11.2 atau yang lebih baru agar fitur-fitur ini tersedia.

Unduh versi terbaru dari agen instrumentasi otomatis AWS Distro untuk OpenTelemetry Java. Anda dapat mengunduh versi terbaru dengan menggunakan perintah ini:
```
curl -L -O https://github.com/aws-observability/aws-otel-java-instrumentation/releases/latest/download/aws-opentelemetry-agent.jar
```
Anda dapat melihat informasi tentang semua versi yang dirilis di aws-otel-java-instrumentation Rilis.
Untuk mengaktifkan eksportir berbeda yang secara langsung mengirimkan telemetri ke titik akhir OTLP dan untuk mengoptimalkan manfaat, gunakan variabel lingkungan berikut sebelum Anda memulai aplikasi:

Jejak:
- Setel OTEL_EXPORTER_OTLP_TRACES_ENDPOINT untuk menentukan titik akhir jejak X-Ray OTLP: https://xray.[AWSRegion].amazonaws.com/v1/traces
  
  Misalnya:
```
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://xray.us-west-2.amazonaws.com/v1/traces"
```
- Setel OTEL_TRACES_EXPORTER ke otlp (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
- OTEL_EXPORTER_OTLP_TRACES_PROTOCOLAtur variabel ke http/protobuf (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
- Tetapkan OTEL_RESOURCE_ATTRIBUTES variabel untuk menentukan informasi berikut sebagai pasangan kunci-nilai. Variabel lingkungan ini digunakan oleh Sinyal Aplikasi, dan diubah menjadi anotasi jejak X-Ray dan dimensi CloudWatch metrik. :
  - (Opsional) service.name menetapkan nama layanan. Ini akan ditampilkan sebagai nama layanan untuk aplikasi Anda di dasbor Sinyal Aplikasi. Jika Anda tidak memberikan nilai untuk kunci ini, maka UnknownService digunakan sebagai nilai default.
  - (Opsional) deployment.environment menetapkan lingkungan tempat aplikasi berjalan. Ini akan ditampilkan sebagai lingkungan Hosted In aplikasi Anda.
  - (Opsional) Untuk mengaktifkan korelasi log, diOTEL_RESOURCE_ATTRIBUTES, tetapkan variabel lingkungan tambahan aws.log.group.names untuk grup log aplikasi Anda. Dengan demikian, jejak dan metrik dari aplikasi Anda dapat dikorelasikan dengan entri log yang relevan dari grup log ini. Untuk variabel ini, ganti $YOUR_APPLICATION_LOG_GROUP dengan nama grup log untuk aplikasi Anda. Jika Anda memiliki beberapa grup log, Anda dapat menggunakan ampersand (&) untuk memisahkannya seperti dalam contoh ini:. aws.log.group.names=log-group-1&log-group-2 Untuk mengaktifkan metrik untuk mencatat korelasi, pengaturan variabel lingkungan saat ini sudah cukup. Untuk informasi selengkapnya, lihat Mengaktifkan metrik untuk mencatat korelasi. Untuk mengaktifkan korelasi trace to log, Anda juga perlu mengubah konfigurasi logging di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan korelasi jejak ke log.
Log:
- Setel OTEL_EXPORTER_OTLP_LOGS_ENDPOINT untuk menentukan titik akhir log CloudWatch OTLP: https://logs.[AWSRegion].amazonaws.com/v1/logs
  
  Misalnya:
```
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://logs.us-west-2.amazonaws.com/v1/logs"
```
- Setel OTEL_EXPORTER_OTLP_LOGS_HEADERS untuk menentukan grup log dan aliran log (catatan: ini harus dibuat sebelum menjalankan ADOT) Anda ingin mengekspor log Anda ke: x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]
  
  Misalnya:
```
export OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default
```
- Setel OTEL_LOGS_EXPORTER ke otlp (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
- OTEL_EXPORTER_OTLP_LOGS_PROTOCOLAtur variabel ke http/protobuf (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).

Setel JAVA_TOOL_OPTIONS untuk menentukan jalur tempat agen instrumentasi otomatis AWS Distro untuk OpenTelemetry Java disimpan. Misalnya:


export JAVA_TOOL_OPTIONS=" -javaagent:$AWS_ADOT_JAVA_INSTRUMENTATION_PATH"
export AWS_ADOT_JAVA_INSTRUMENTATION_PATH="./aws-opentelemetry-agent.jar"

Aplikasi Anda sekarang harus berjalan dengan instrumentasi ADOT Java dan akan menghasilkan rentang dan log. Rentang akan disimpan dalam grup aws/spans CloudWatch log, sedangkan log akan disimpan dalam grup log yang ditentukan di OTEL_EXPORTER_OTLP_LOGS_HEADERS header. Anda juga dapat melihat log dan metrik yang berkorelasi dengan rentang Anda di Konsol CloudWatch Jejak dan Metrik.

Mulai aplikasi Anda dengan variabel lingkungan yang tercantum pada langkah sebelumnya. Berikut ini adalah sebuah contoh skrip awal.


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

catatan

Anda harus menggunakan ADOT JavaScript versi 0.7.0 atau yang lebih baru agar fitur-fitur ini tersedia.

Unduh versi terbaru AWS Distro untuk instrumentasi OpenTelemetry JavaScript otomatis. Instal dengan menjalankan perintah berikut.
```
npm install @aws/aws-distro-opentelemetry-node-autoinstrumentation
```
Anda dapat melihat informasi tentang semua versi yang dirilis di aws-otel-js-instrumentation Rilis.
Untuk mengaktifkan eksportir berbeda yang secara langsung mengirimkan telemetri ke titik akhir OTLP dan untuk mengoptimalkan manfaat, gunakan variabel lingkungan berikut sebelum Anda memulai aplikasi:

Jejak:
- Setel OTEL_EXPORTER_OTLP_TRACES_ENDPOINT untuk menentukan titik akhir jejak X-Ray OTLP: https://xray.[AWSRegion].amazonaws.com/v1/traces
  
  Misalnya:
```
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://xray.us-west-2.amazonaws.com/v1/traces"
```
- Setel OTEL_TRACES_EXPORTER ke otlp (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
- OTEL_EXPORTER_OTLP_TRACES_PROTOCOLAtur variabel ke http/protobuf (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
- Tetapkan OTEL_RESOURCE_ATTRIBUTES variabel untuk menentukan informasi berikut sebagai pasangan kunci-nilai. Variabel lingkungan ini digunakan oleh Sinyal Aplikasi, dan diubah menjadi anotasi jejak X-Ray dan dimensi CloudWatch metrik. :
  - (Opsional) service.name menetapkan nama layanan. Ini akan ditampilkan sebagai nama layanan untuk aplikasi Anda di dasbor Sinyal Aplikasi. Jika Anda tidak memberikan nilai untuk kunci ini, maka UnknownService digunakan sebagai nilai default.
  - (Opsional) deployment.environment menetapkan lingkungan tempat aplikasi berjalan. Ini akan diputar sebagai lingkungan Hosted In aplikasi Anda.
  - (Opsional) Untuk mengaktifkan korelasi log, diOTEL_RESOURCE_ATTRIBUTES, tetapkan variabel lingkungan tambahan aws.log.group.names untuk grup log aplikasi Anda. Dengan demikian, jejak dan metrik dari aplikasi Anda dapat dikorelasikan dengan entri log yang relevan dari grup log ini. Untuk variabel ini, ganti $YOUR_APPLICATION_LOG_GROUP dengan nama grup log untuk aplikasi Anda. Jika Anda memiliki beberapa grup log, Anda dapat menggunakan ampersand (&) untuk memisahkannya seperti dalam contoh ini:. aws.log.group.names=log-group-1&log-group-2 Untuk mengaktifkan metrik untuk mencatat korelasi, pengaturan variabel lingkungan saat ini sudah cukup. Untuk informasi selengkapnya, lihat Mengaktifkan metrik untuk mencatat korelasi. Untuk mengaktifkan korelasi trace to log, Anda juga perlu mengubah konfigurasi logging di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan korelasi jejak ke log.
Log:
- Setel OTEL_EXPORTER_OTLP_LOGS_ENDPOINT untuk menentukan titik akhir log CloudWatch OTLP: https://logs.[AWSRegion].amazonaws.com/v1/logs
  
  Misalnya:
```
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://logs.us-west-2.amazonaws.com/v1/logs"
```
- Setel OTEL_EXPORTER_OTLP_LOGS_HEADERS untuk menentukan grup log dan aliran log (catatan: ini harus dibuat sebelum menjalankan ADOT) Anda ingin mengekspor log Anda ke: x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]
  
  Misalnya:
```
export OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default
```
- Setel OTEL_LOGS_EXPORTER ke otlp (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
- OTEL_EXPORTER_OTLP_LOGS_PROTOCOLAtur variabel ke http/protobuf (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
Aplikasi Anda sekarang harus berjalan dengan JavaScript instrumentasi ADOT dan akan menghasilkan rentang dan log. Rentang akan disimpan dalam grup aws/spans CloudWatch log, sedangkan log akan disimpan dalam grup log yang ditentukan di OTEL_EXPORTER_OTLP_LOGS_HEADERS header. Anda juga dapat melihat log dan metrik yang berkorelasi dengan rentang Anda di Konsol CloudWatch Jejak dan Metrik.

Mulai aplikasi Anda dengan variabel lingkungan yang tercantum pada langkah sebelumnya. Berikut ini adalah sebuah contoh skrip awal.

Ganti $SVC_NAME dengan nama aplikasi Anda. Ini akan ditampilkan sebagai nama aplikasi.


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

catatan

Anda harus menggunakan ADOT Python versi 0.10.0 atau yang lebih baru dan botocoretelah menginstal agar fitur-fitur ini tersedia.

Unduh versi terbaru dari AWS Distro untuk instrumentasi otomatis OpenTelemetry Python. Instal dengan menjalankan perintah berikut.
```
pip install aws-opentelemetry-distro
```
Anda dapat melihat informasi tentang semua versi yang dirilis di aws-otel-python-instrumentation Rilis.
Untuk mengaktifkan eksportir berbeda yang secara langsung mengirimkan telemetri ke titik akhir OTLP dan untuk mengoptimalkan manfaat, gunakan variabel lingkungan berikut sebelum Anda memulai aplikasi:

Untuk konfigurasi jejak dan log, Anda harus mengatur variabel lingkungan berikut:
- OTEL_PYTHON_DISTRO untuk aws_distro
- OTEL_PYTHON_CONFIGURATOR untuk aws_configurator
Jejak:
- Setel OTEL_EXPORTER_OTLP_TRACES_ENDPOINT untuk menentukan titik akhir jejak X-Ray OTLP: https://xray.[AWSRegion].amazonaws.com/v1/traces
  
  Misalnya:
```
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://xray.us-west-2.amazonaws.com/v1/traces"
```
- Setel OTEL_TRACES_EXPORTER ke otlp (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
- OTEL_EXPORTER_OTLP_TRACES_PROTOCOLAtur variabel ke http/protobuf (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
- Tetapkan OTEL_RESOURCE_ATTRIBUTES variabel untuk menentukan informasi berikut sebagai pasangan kunci-nilai. Variabel lingkungan ini digunakan oleh Sinyal Aplikasi, dan diubah menjadi anotasi jejak X-Ray dan dimensi CloudWatch metrik. :
  - (Opsional) service.name menetapkan nama layanan. Ini akan ditampilkan sebagai nama layanan untuk aplikasi Anda di dasbor Sinyal Aplikasi. Jika Anda tidak memberikan nilai untuk kunci ini, maka UnknownService digunakan sebagai nilai default.
  - (Opsional) deployment.environment menetapkan lingkungan tempat aplikasi berjalan. Ini akan diputar sebagai lingkungan Hosted In aplikasi Anda.
  - (Opsional) Untuk mengaktifkan korelasi log, diOTEL_RESOURCE_ATTRIBUTES, tetapkan variabel lingkungan tambahan aws.log.group.names untuk grup log aplikasi Anda. Dengan demikian, jejak dan metrik dari aplikasi Anda dapat dikorelasikan dengan entri log yang relevan dari grup log ini. Untuk variabel ini, ganti $YOUR_APPLICATION_LOG_GROUP dengan nama grup log untuk aplikasi Anda. Jika Anda memiliki beberapa grup log, Anda dapat menggunakan ampersand (&) untuk memisahkannya seperti dalam contoh ini:. aws.log.group.names=log-group-1&log-group-2 Untuk mengaktifkan metrik untuk mencatat korelasi, pengaturan variabel lingkungan saat ini sudah cukup. Untuk informasi selengkapnya, lihat Mengaktifkan metrik untuk mencatat korelasi. Untuk mengaktifkan korelasi trace to log, Anda juga perlu mengubah konfigurasi logging di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan korelasi jejak ke log.
Log:
- Setel OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED ke true
- Setel OTEL_EXPORTER_OTLP_LOGS_ENDPOINT untuk menentukan titik akhir log CloudWatch OTLP: https://logs.[AWSRegion].amazonaws.com/v1/logs
  
  Misalnya:
```
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://logs.us-west-2.amazonaws.com/v1/logs"
```
- Setel OTEL_EXPORTER_OTLP_LOGS_HEADERS untuk menentukan grup log dan aliran log (catatan: ini harus dibuat sebelum menjalankan ADOT) Anda ingin mengekspor log Anda ke: x-aws-log-group=[CW-LOG-GROUP-NAME],x-aws-log-stream=[CW-LOG-STREAM-NAME]
  
  Misalnya:
```
export OTEL_EXPORTER_OTLP_LOGS_HEADERS=x-aws-log-group=MyLogGroup,x-aws-log-stream=default
```
- Setel OTEL_LOGS_EXPORTER ke otlp (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
- OTEL_EXPORTER_OTLP_LOGS_PROTOCOLAtur variabel ke http/protobuf (ini opsional dan merupakan nilai default jika variabel lingkungan ini tidak disetel).
Aplikasi Anda sekarang harus berjalan dengan instrumentasi ADOT Python dan akan menghasilkan rentang dan log. Rentang akan disimpan dalam grup aws/spans CloudWatch log, sedangkan log akan disimpan dalam grup log yang ditentukan di OTEL_EXPORTER_OTLP_LOGS_HEADERS header. Anda juga dapat melihat log dan metrik yang berkorelasi dengan rentang Anda di Konsol CloudWatch Jejak dan Metrik.

Mulai aplikasi Anda dengan variabel lingkungan yang tercantum pada langkah sebelumnya. Berikut ini adalah sebuah contoh skrip awal.

Ganti $SVC_NAME dengan nama aplikasi Anda. Ini akan ditampilkan sebagai nama aplikasi.

Ganti $PYTHON_APP dengan lokasi dan nama aplikasi Anda.


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

catatan

ADOT.NET versi 1.8.0 atau yang lebih baru diperlukan agar fitur-fitur ini tersedia.
Kompresi saat ini tidak didukung.
Log saat ini tidak didukung.

Unduh versi terbaru paket instrumentasi otomatis AWS Distro for OpenTelemetry .NET. Anda dapat melihat informasi tentang semua versi yang dirilis di aws-otel-dotnet-instrumentation Rilis.

Untuk mengaktifkan eksportir berbeda yang secara langsung mengirimkan telemetri ke titik akhir OTLP dan untuk mengoptimalkan manfaat, gunakan variabel lingkungan berikut sebelum Anda memulai aplikasi (ganti dotnet-service-name dalam variabel OTEL_RESOURCE_ATTRIBUTES lingkungan dengan nama layanan pilihan Anda):

Jejak:

Anda harus mengatur OTEL_TRACES_EXPORTER ke none
Anda harus mengatur OTEL_AWS_SIG_V4_ENABLED ke true

Fitur ini tidak diaktifkan secara otomatis di .NET. Variabel lingkungan diperlukan secara khusus untuk mengidentifikasi kasus penggunaan ini dalam instrumentasi .NET. Persyaratan ini unik untuk.NET dan tidak berlaku untuk bahasa lain yang didukung.

Berikut ini adalah contoh setup untuk 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

Berikut ini adalah contoh pengaturan untuk 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

Mulai aplikasi Anda dengan variabel lingkungan yang tercantum pada langkah sebelumnya.

(Opsional) Atau, Anda dapat menggunakan skrip instalasi yang disediakan untuk membantu instalasi dan penyiapan AWS Distro untuk paket instrumentasi OpenTelemetry otomatis.NET.

Untuk Linux, unduh dan instal skrip instalasi Bash dari halaman GitHub rilis:


# 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

Untuk Windows Server, unduh dan instal skrip PowerShell instalasi dari halaman GitHub rilis:


# 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

Anda dapat menemukan NuGet paket paket instrumentasi otomatis AWS Distro untuk OpenTelemetry .NET di repositori resmi. NuGet Pastikan untuk memeriksa file README untuk instruksi.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Bangun OpenTelemetry Kolektor kustom Anda sendiri

Pemecahan Masalah