OpenTelemetry

OpenTelemetry kaynakları ve Altyapı ilişkileri

Instana, OpenTelemetry Kaynak özniteliklerini destekler. Instana, bir YönOrtamıana aracısı aynı anasistemde çalışırken OpenTelemetry kaynaklarını geliştirebilir. Instana OpenTelemetry kaynak algılayıcı çalışmasını sağlamak için bir Instana aracısı konuşlandırmanız ve aracıyı aynı anasistemde çalıştırmanız gerekir.

Instana OpenTelemetry kaynak algılayıcıları, OpenTelemetry izleme bilgilerini ek kaynak öznitelikleriyle zenginleştirir. Ek öznitelikler, izleme verileri ile temel altyapı varlıkları arasında bir link oluşturulmasına yardımcı olur.

Kaynağa aşağıdaki alanlar eklenir:

• process.pid: Kök PID ad alanındaki sürecin PID 'si.
• instana.host.id: Bu anasistemdeki YönOrtamıaracı UUID 'si.
• service.instance.id: OpenTelemetry hizmetinin tanıtıcısı. Bu tanıtıcı, izleme verilerini süreç varlığıyla ilintilendirmek için kullanılır.

Linux anasistemlerinde altyapı ilintilendirmesiyle ilgili ayrıntılı bilgi için bkz. aracının HTTP API uç noktası.

See the following available Instana OpenTelemetry Resource detectors:

• Node.js: @opentelemetry/resource-detector-instana.

OpenTelemetry İzleme

OpenTelemetry özelliğini YönOrtamı'nınkendi AutoTrace teknolojisiyle tam olarak birlikte çalışabilir hale getirmek için çalışmalar devam ediyor

Instana, OpenTelemetry izleriyle sorunsuz bir şekilde bütünleşebilir. Instana, OpenTelemetry izlemelerini, varsayılan W3C İzleme Bağlamını Kullanan, Instana tarafından oluşturulan izlemeleri kullanarak ilişkilendirir.

Instana, çoğu OpenTelemetry İzleme Semantik Kurallarınıdestekler.

OpenTelemetry metrikleri

OpenTelemetry metrikleri, toplandıkları yerden aracı, ana makine veya işlemle ilişkili "OpenTelemetry Custom Metrics" olarak görünür. OpenTelemetry varlıkları, Altyapı Analitiği altında OpenTelemetrytipi altında bulunabilir. "Olay ve Uyarılar" ya da Altyapı Haritası için, entity.type:opentelemetry ya da entity.type:otelile "Dinamik Odak" özelliğini kullanarak OpenTelemetry özel ölçümlerini sorgulayabilirsiniz.

Algılayıcı aşağıdaki metrik türlerini toplar:

• Göstergeler
• Histogramlar
• Özetler

OpenTelemetry günlükleri

OpenTelemetry günlüklerinin toplanması halen geliştirme ve test aşamasındadır. Anasistem aracısı, OpenTelemetry günlük verilerini alırsa bazı iyi huylu özel durumları gösterir. OpenTelemetry günlükleri, aşağıdaki yöntemler kullanılarak YönOrtamıana arka ucuna sindirilir:

1. Günlükleri doğrudan OTLP protokolüyle ya da OpenTelemetry toplayıcısı aracılığıyla YönOrtamıana arka ucuna otlp-acceptor gönderin.

2. İçgüdü için veri toplayan YönOrtamıana aracısıyla günlükleri Ingest.

   

OTLP verilerinin YönOrtamıAna aracısına gönderilmesi

OpenTelemetry , anasistem aracısını yetkili sunucu olarak kullanarak, izleme ve metrik verilerini YönOrtamıana aracısına gönderebilir. Daha sonra veriler işlenmek üzere YönOrtamıana arka ucuna gönderilir.

Anasistem aracısındaki OpenTelemetry alımı, anasistemdeki diğer toplayıcılarla etkileşimde bulunmamak için varsayılan olarak devre dışı bırakılır. Anasistem aracısında OpenTelemetry verilerinin alınmasını etkinleştirmek için, anasistem aracınızın configuration.yamlürününe aşağıdaki parçacığı ekleyin:

com.instana.plugin.opentelemetry:
  enabled: <boolean>   # legacy setting, will only enable grpc, defaults to false
  grpc:
    enabled: <boolean> # takes precedence over legacy settings above, defaults to true if "grpc:" is present
  http:
    enabled: <boolean> # allows to enable http endpoints, defaults to true if "http:" is present

Yapılandırma etkinleştirildikten sonra, anasistem aracısı OpenTelemetry' nin varsayılan OTLP (OpenTelemetry iletişim kuralı) dışa aktarıcısı için bir toplayıcıyı gRPC için 4317 kapısında ve HTTP ya da HTTPS bağlantıları için 4318 kapısında otomatik olarak etkinleştirir.

OTLP verilerinin Instana arka ucuna Gönderilmesi

Uygulamalar ya da sistemler, verileri doğrudan YönOrtamıana arka ucuna göndermek için OTLP protokolünü kullanabilir. otlp-acceptor bileşeninin özel uç noktası kullanılır. Instana arka ucunuzun otlp-acceptor bileşeninin etkinleştirildiğinden emin olun. Doğrulama için gerekli YönOrtamıanahtarı da ayarlamanız gerekir. Instana otlp-acceptor bileşenine bağlanmak için kullanılan OpenTelemetry Collector olanağının kullanılmasına ilişkin aşağıdaki örnek yapılandırmaya bakın:

exporters:
  otlp:
    endpoint: otlp-xxxx-saas.instana.io:4317
    headers:
      x-instana-key: xxxxxxx

Not: x-instana-key alanını, hedefleme YönOrtamı-ucu için YönOrtamıaracı anahtarıyla ayarlayın. Uç nokta alanı için YönOrtamı'nizin arka ucunun doğru anasistem adını kullanın. Kendi kendine barındırılan Instana arka ucunun herhangi bir anasistem adı olabilir ve "otlp-xxxx-saas.instana.io" olması gerekmez.

YönOrtamıAna Dışa Aktarıcı kullanılarak YönOrtamıana arka ucuna yerli verilerin gönderilmesi

İlgili dil tabanlı OpenTelemetry SDK için çalışmak üzere ilgili dil tabanlı YönOrtamıDışa Aktarıcıyı uygulamalarınıza yüklemeniz gerekir. OpenTelemetry topluluğunda gittikçe daha fazla kişi yerel OTLP protokolünü seçse de, bu basit çözüm hala kullanılabilir. Here are available Instana OpenTelemetry Exporters:

• Serverless Node.js Instana OpenTelemetry dışa aktarıcı: @instana/opentelemetry-exporter
• Serverless .NET Instana OpenTelemetry dışa aktarıcı: OpenTelemetry.Exporter.Instana
• Serverless Go Instana OpenTelemetry dışa aktarıcı: github.com/instana/go-otel-exporter

OpenTelemetry Contrib Collector Olanağının Kullanılması

Uygulamalar ya da sistemler, OpenTelemetry Contrib Collector' a veri göndermek için OTLP iletişim kuralını kullanabilir. Daha sonra, OpenTelemetry Contrib Toplayıcısı verileri, YönOrtamıAna Dışa Aktarıcısı 'nı kullanarak YönOrtamıana arka ucu önem derecesiz alıcısına iletir. Instana arka uç sunucusu olmayan alıcısına veri göndermek için, anasistem aracısının configuration.yaml dosyasını aşağıdaki gibi yapılandırın:

exporters:
  instana:
    endpoint: "https://xxxxxx/serverless"
    agent_key: "xxxxxxxxxx"

agent_key alanını YönOrtamı_Aracı anahtarıyla ayarlayın. Not: Sunucusu olmayan kabul edenin "Content-Length" sınırı 50000000 'dir. İstek sınırı aşarsa, bir "413 İstek Varlığı Çok Büyük" hatası görebilirsiniz. Bu nedenle, otel contrib toplayıcısının toplayıcı yapılandırma dosyasını da değiştirmeniz gerekir: 1. Instana dışa aktarıcı ile birlikte kullanılacak özel bir toplu iş işlemcisi eşgörünümü yaratın. 2. Toplu iş işlemcisinin send_batch_max_size değiştirgesini doğru bir değere ayarlayın (varsayılan olarak sınır yoktur). Daha fazla bilgi için bkz. benioku dosyası.

OpenTelemetry çağrılarının çözümlenmesi

OpenTelemetry ürününü, YönOrtamı'nınkendi AutoTrace teknolojisiyle tam birlikte çalışabilirlik yeteneğine sahip birinci sınıf bir vatandaş haline getirmek için çalışıyoruz. Bu nedenle, OpenTelemetryile etkinleştirilen uygulamalar ya da sistemler tarafından bir izlemenin tüm yayımı ya da kısmi yayımı, yerel YönOrtamıcı izleyicilerinden gelen tüm izlerle karşılaştırılırsa, hemen hemen hiçbir farklılık yoktur. Çağrı analitiğinin aynı yöntemi kullanılabilir.

OpenTelemetryçağrılarını süzmek için süzgeç sorgusunu OpenTelemetry kaynak özniteliği service.name ve is presentolarak ayarlayın. Kaynak semantik kuralları için OpenTelemetry belirtimi OpenTelemetry kaynak özniteliğini service.namegerektirdiğinden bu süzgeç sorgusunu ayarlamanız gerekir. OpenTelemetry , hizmet adını belirtmenin çeşitli yollarını sağlar. Daha fazla bilgi için OpenTelemetry resmi belgelerinebakın.

Her OpenTelemetry özniteliği ve OpenTelemetry kaynak özniteliği aşağıdaki etiketlerle gösterilir:

• Dinamik etiketler: Bu etiketler, Instana 'ya gönderilen ve çağrı etiketleri kataloğunda bulunan tüm OpenTelemetry özniteliklerinden hesaplanır. Dinamik etiketler, doğrudan etiket kataloğundan http.methodgibi adlara göre kolayca aranabilir. Etiket kataloğuna konan dinamik etiketlerin sayısı 500 farklı öznitelik adıyla sınırlıdır. Bu sınırı aşarsanız, bu sınırlamaya sahip olmadıklarına göre süzmek ve gruplamak için yalnızca statik etiketleri kullanın.

  

• Statik etiketler: Bu etiketler, Instana 'ya gönderilen tüm OpenTelemetry özniteliklerine ya da OpenTelemetry kaynak özniteliklerine erişim sağlar. Statik etiketlere göre süzmek ya da gruplamak için önce OpenTelemetry Tag ya da OpenTelemetry Resource Tag seçeneğini belirlemeniz ve ardından öznitelik adını anahtar olarak belirtmeniz gerekir.

  

500 OpenTelemetry öznitelik sınırını aşarsanız, özel OpenTelemetry öznitelikleriniz için adlandırma kuralınızı gözden geçirmeniz gerekir. Örneğin, A/B testini izlemek istiyorsanız, user-123-ab-test=agibi her kullanıcı için yeni bir öznitelik yaratmak yerine, iki öznitelik user-id=123 ve ab-test=akullanabilirsiniz. İki ayrı etiket kullanarak, farklı OpenTelemetry etiketlerinin toplam sayısını düşük tutarken verilerinizi kolayca süzebilir ya da gruplayabilirsiniz.

Hizmet eşleme

Varsayılan hizmet kurallarını kullanarak, YönOrtamıana Hizmeti 'ni eşlemek için birden çok kaynak ve izleme özniteliği kullanabilirsiniz. Daha önce de belirtildiği gibi, OpenTelemetry Kaynak özniteliği service.name yerel YönOrtamı-Hizmet olarak eşlemek için çok sık kullanılır. Diğer öznitelikleri aşağıdaki gibi de kullanabilirsiniz:

• OpenTelemetry İzleme kapsamı özniteliği peer.service , uzak YönOrtamıAna Hizmeti olarak eşlemek için kullanılır.
• OpenTelemetry İzleme kapsamı özniteliği messaging.destination , bir iç dönüştürme kullanılarak call.messaging.address kuralından çıkılarak uzak YönOrtama Hizmeti olarak eşlemek için kullanılır.

OpenTelemetry Yaydırıcılar

Yayıcılar, satıcıya özgü izleme ilintisi üstbilgileri ile OpenTelemetry izleme bağlamı arasında çeviri yapar. If an incoming HTTP request contains the proprietary Instana trace correlation headers (X-INSTANA-T and X-INSTANA-S), the Instana OpenTelemetry propagator creates an OpenTelemetry trace context with the trace ID and span ID from those headers. OpenTelemetry izleyicisi bu izleme bağlamından izlemeye devam edebilir. Also, if an OpenTelemetry trace context exists, the Instana OpenTelemetry propagator will use it to inject the proprietary Instana trace correlation headers into outgoing requests.

Not: YönOrtamıcı izleyicileri, OpenTelemetrytarafından kullanılan varsayılan ilinti üstbilgisi biçimi olan W3C izleme bağlamı belirtimini destekler. Therefore you usually don't need to add an Instana OpenTelemetry propagator to your application. Tam destek düzeyi hakkında daha fazla bilgi için bkz. W3C İzleme Bağlamı Desteği.

OpenTelemetry Örnekleri

OpenTelemetry örnekleyici, örnekleme kararıverir; başka bir deyişle, belirli bir istek için izleme verilerinin yakalanıp yakalanmayacağına karar verir. Instana OpenTelemetry örnekleyicileri, bu kararı izleme bağlamının sampled işaretine dayalı olarak alır. sampled işaretin değeri falsedeğilse, örnekleyici isteği yakalamaya karar verir.

OTel C++ istemcisi SDK paketi

OTel C++ istemcisi SDK paketi, C + + için OpenTelemetry OTLP dışa aktarıcıdır. Paket, Opentelemetry-cppüzerine oluşturulmuştur. Daha fazla bilgi için bkz. OTel C++ istemcisi SDK paketinin kurulması.