Geschäftskennzahlen (öffentliche Vorschau)

Online bearbeiten

Über „ OpenTelemetry “ ( OTel ) können Sie Geschäftsdaten direkt im „ OTLP “-Format aus Ihren Anwendungen oder Systemen an das Backend von „ Instana “ übertragen.

Voraussetzungen

Online bearbeiten

Ermitteln Sie die Bereitstellungsregion Ihres „ Instana “, da der Backend-Endpunkt regionabhängig ist. Um Ihre umgebungsspezifische „ Instana “-Region zu ermitteln, klicken Sie im Navigationsmenü der Benutzeroberfläche von „ Instana “ auf „Mehr“ > „Über Instana “. Im Dialogfeld „ Instana “ wird Ihre Bereitstellungsregion angezeigt.

Jede Umgebung unter InstanaSaaS ist mit einem bestimmten Regionsnamen verknüpft, beispielsweise „blue“, „red“, „green“, „orange“ oder „coral“. Weitere Informationen zum Endpunkt des Backends „otlp-acceptor“ von „ Instana “ finden Sie unter „Endpunkte des Backends ‚otlp-acceptor‘ von ‚ Instana ‘“.

Senden von Metriken mithilfe von OTLP

Online bearbeiten

Um Metriken im Format „ OTLP “ zu senden, führen Sie die folgenden Schritte aus:

  1. Installieren Sie das SDK „ OpenTelemetry “ und den Exporter „ OTLP “ für Ihre Programmiersprache.
  2. Konfigurieren Sie den Exporter „ OTLP “. a. Legen Sie den Endpunkt „ OTLP “ fest. Weitere Informationen finden Sie unter „Endpunkte des Backends ‚otlp-acceptor‘ von Instana “. b. Fügen Sie die folgenden obligatorischen Kopfzeilen ein:
    • "x-instana-key": "your-instana-agent-key"
    • "x-instana-host": "-"
    • "x-instana-metric-category": "business"
  3. Initialisieren Sie den Metrik-Provider und fügen Sie einen Metrik-Exporter (z. B. PeriodicExportingMetricReader) hinzu, um die regelmäßig gesendeten Metrikdaten zu verarbeiten.
  4. Eine Kennzahl definieren und erfassen. Der Typ „Gauge Metric“ ist die einzige unterstützte Option. Fügen Sie bei Bedarf Attribute hinzu.

Beispiel: Direkte Übermittlung von Geschäftskennzahlen an das Backend von „ Instana “ mithilfe des OTEL- Python -SDK-Pakets

Online bearbeiten
pip install opentelemetry-sdk
pip install opentelemetry-exporter-otlp

from opentelemetry.metrics import (
get_meter_provider,
set_meter_provider,
)

from opentelemetry.exporter.otlp.proto.grpc.metric_exporter import OTLPMetricExporter
from opentelemetry.sdk.resources import Resource
from opentelemetry.sdk.metrics import MeterProvider
from opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader

# Define mandatory headers
headers =  {
"x-instana-key": "xxx",
"x-instana-host": "-",
"x-instana-metric-category": "business"
}

exporter = OTLPMetricExporter(endpoint="https://{INSTANA_OTLP_GRPC_BACKEND}:4317", headers=headers, insecure=True)

reader = PeriodicExportingMetricReader(exporter)
provider = MeterProvider(metric_readers=[reader])
set_meter_provider(provider)

# Define customer segment as an attribute
attributes = {
"customer_segment": "enterprise",
}

# Get the meter and define a revenue gauge
meter = get_meter_provider().get_meter("Company.Department", version="1.0", attributes=attributes)
gauge = meter.create_gauge(
"Revenue",
unit="USD"
)

# Set the revenue value (e.g., $50,000)
gauge.set(50000, attributes)