Sıla SarıGiriş
Bu doküman OpenTelemetry .NET otomatik enstrümasyonu kullanarak .NET uygulamalarından ve servislerinden kaynak kodlarını değiştirmeden izleme verilerini görebilmeyi maddelerle açıklamaktadır.
Gereksinimler
En düşük desteklenen .NET Framework sürümü 4.6.2'dir.
Adımlar
1. Bash script'i indirin
Bu script, otomatik kurulumu sağlayacak olan temel dosyaları içerir.
curl -sSfL https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/releases/latest/download/otel-dotnet-auto-install.sh -O
2. Çekirdek dosyaları yükleyin
İndirdiğimiz bash script'ini kullanarak, OpenTelemetry .NET için gerekli olan dosyaları yüklüyoruz. Bu adım, enstrümantasyonun çalışması için gerekli olan alt yapıyı hazırlar.
sh ./otel-dotnet-auto-install.sh
3.Enstrümantasyonun betiğinin çalıştırılabilir yapılmasını sağlayın
Bu adım betiğin başarıyla tamamlanabilmesi için gereklidir.
. $HOME/.otel-dotnet-auto/instrument.sh
4. Geçerli kabuk oturumu için enstrümantasyonu ayarlama
Bu komut uygulamayı etkinleştirilmiş OpenTelemetry izleme işlemleriyle çalıştırmak için kullanılır.
OTEL_EXPORTER_OTLP_ENDPOINT=your-endpoint OTEL_SERVICE_NAME=your-app OTEL_RESOURCE_ATTRIBUTES=deployment.environment=staging,service.version=1.0.0 ./your-app
Projeniz .NET 8 ile derlendiğinde, çalıştırılabilir uygulamanız genellikle proje dizininizdeki bin/debug veya bin/Release klasörlerinde bulunur. Terminal veya Komut istemi üzerinden proje dizinine giderek bin/debug klasörüne erişin. Burada, .NET 8 tarafından derlenen ve çalıştırılabilir hale getirilen uygulamanızın adını (your-app) ve konumunu bulabilirsiniz.
OTEL_EXPORTER_OTLP_ENDPOINT ayarı, izleme verilerinin gönderileceği OpenTelemetry collector veya başka bir izleme backend'ini belirtir;
OTEL_SERVICE_NAME, izleme verilerinde kullanılacak servis adını tanımlar;
OTEL_RESOURCE_ATTRIBUTES ise uygulamanızın dağıtım ortamı (örneğin, staging) ve sürümü (1.0.0) gibi ek bilgiler sağlar.
Komut satırı seçenekleri veya ortam değişkenleri aracılığıyla uygulamanızı başlatırken ek parametreler (örneğin OTEL_LOG_LEVEL=debug) veya çevresel değişkenler kullanabilirsiniz.
Not:İzlemek istediğiniz servisin ismini görmenize rağmen verileri göremiyorsanız uygulamanızın saatini kontrol etmeniz faydalı olacaktır.
