Back-End-Korrelation

Sie müssen die in diesem Dokument beschriebenen Schritte nicht befolgen, um die Website-Überwachung von Instana zu nutzen. Die Schritte beschreiben, wie die Back-End-Korrelation verbessert oder aktiviert werden kann, z. B. zur Unterstützung der Back-End-Korrelation für ältere Web-Browser oder zur Unterstützung der Back-End-Korrelation über verschiedene Ursprünge hinweg. Die meisten Back-End-Korrelationen sind automatisch. Führen Sie die folgenden Schritte aus, um die Back-End-Korrelationsabdeckung zu erweitern. Diese Schritte sind optional. Sie können sie in der Reihenfolge befolgen, wenn Sie eine fehlende Back-End-Korrelation ermitteln.

Instana kann eine Verbindung zwischen Backend- und Website-Aktivitäten herstellen, wenn die Backend-Aktivitäten nachverfolgt werden. Als Voraussetzung für die Korrelation müssen Sie die Erfassung von Backend-Daten, auch Tracing genannt, aktivieren. Informationen zum Aktivieren der Ablaufverfolgung finden Sie unter „Ablaufverfolgung“ auf Instana.

Instana Das Skript zur Website-Überwachung unterstützt die folgenden Arten von Backend-Korrelationstechnologien:

• Instana Nachverfolgung
• W3C Trace-Kontext

Wenn Sie mehr über den Back-End-Korrelationsprozess erfahren möchten, müssen Sie über ein gutes Verständnis des Konzepts der Ursprünge verfügen. Der FAQ-Artikel „ Instana “ erläutert, was Sie über Ursprünge wissen müssen, um die folgenden Schritte zu verstehen:

Die Verwendung von XMLHttpRequest ` fetchAPI ` in Verbindung mit funktioniert bei allen Aufrufen innerhalb derselben Herkunft zuverlässig. Aufgrund der Same-Origin-Policy und Cross-Origin ist die automatische Korrelation von Aufrufen an das Backend von „ HTTP “ nicht möglich.

Um die Backend-Korrelation bei mehreren Ursprüngen zu ermöglichen, wird das Cross-Origin Resource Sharing ( CORS ) verwendet. CORS ist ein Mechanismus, der kontrollierte Ausnahmen vom Sicherheitsmechanismus der Same-Origin-Policy festlegt. Informationen zu den Einschränkungen, die für Richtlinien mit demselben Ursprung gelten, finden Sie im folgenden Screenshot, in dem beschrieben wird, was erforderlich ist.

Back-End-Traces und das Laden von Websiteseiten, d. h. der Abruf der ursprünglichen HTML-Dateien, werden automatisch für Web-Browser korreliert, die Unterstützung Server-Timingverwendet. Durch manuelles Aufdecken der Trace-ID des ersten Seitenaufbaus an den JavaScript-Agenten ist es möglich, die Back-End-Korrelation für alle Web-Browser zu aktivieren. Zum Aktivieren der Back-End-Korrelation müssen Sie die folgenden Schritte ausführen:

1. Abrufen der Trace-ID auf der Back-End-Seite.
2. Die Trace-ID in den Codeausschnitt „ JavaScript “ von Instana einfügen

// via plain Java Servlet request object (standard API)
// http://docs.oracle.com/javaee/6/api/javax/servlet/ServletRequest.html
servletRequest.getAttribute("X-INSTANA-T")

// via the  $_SERVER superglobal array (standard API)
// http://php.net/manual/en/reserved.variables.server.php
$_SERVER["X-INSTANA-T"]

// via plain Node.js HTTP request objects (standard API)
// https://nodejs.org/api/http.html#http_class_http_incomingmessage
req.headers['x-instana-t']

// via express.js request objects
// https://expressjs.com/en/4x/api.html#req.get
req.get('x-instana-t')

// For ASP.NET WebForms
HttpContext.Current.Items["X-INSTANA-T"]

// For ASP.NET MVC Applications
Context.ApplicationInstance.Context.Items["X-INSTANA-T"]

::Instana.tracer.context &&
  ::Instana::Util.id_to_header(::Instana.tracer.context.trace_id)

# Synchronous (Django, Flask etc..)
from instana.singletons import tracer

from instana.singletons import async_tracer as tracer

tracer.active_span and tracer.active_span.context.trace_id

import instana "github.com/instana/go-sensor"

span := opentracing.StartSpan("MySpanName)
spanContext := span.Context().(instana.SpanContext)
traceId := instana.FormatID(spanContext.TraceID)

<script>
  (function(i,s,o,g,r,a,m){i['InstanaEumObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','https://eum.instana.io/eum.min.js','ineum');

  // API calls as generated by the Instana user interface

  ineum('traceId', '*TraceID*');
</script>

Die Backend-Korrelation für Ressourcen oder Assets, wie Bilder, JavaScript, und CSS-Dateien, erfolgt automatisch:

• Web-Browser, die Unterstützung Server-Timing.
• Ressourcen oder Assets, die von demselben Ursprung wie das HTML-Dokument bereitgestellt werden.

Um die Back-End-Korrelation zu entsperren, wenn mehrere Ursprünge beteiligt sind, verwenden Sie den Header Timing-Allow-Origin. Dieser Header weist den Server timing allow check an, die Daten für JavaScript sowie für den Agenten unter InstanaJavaScript bereitzustellen.

Informationen zum Entsperren von Back-End-Korrelationsfunktionen für die Ressourcen, die aus anderen Ursprüngen als dem Ursprung des HTML-Dokuments abgerufen werden, finden Sie im folgenden Screenshot:

Wenn der Backend-Server mit „ OpenTelemetry “ kompatibel ist, können Sie den Codeausschnitt unter Instana JavaScript um einen Aufruf von ineum('enableW3CHeaders', true);API erweitern. Wenn der Server die traceparent Metadaten in die HTML-Seite einbettet, kann der Agent unter InstanaJavaScriptparent-id den Inhalt analysieren und als Daten backendTraceId für das Beacon unter pageLoad verwenden.

Mit XMLHttpRequest oder fetch call werden traceparent tracestate und generiert und den ursprünglichen „ HTTP “-Headern hinzugefügt. tracestate wird als backendTraceId für das XHR-Beacon verwendet, das an das Backend unter Instana gesendet wird.