Corrélation de back end

Il n'est pas nécessaire de suivre les étapes décrites dans ce document pour utiliser la surveillance de sites Web d' Instana. Les étapes décrivent comment améliorer ou activer la corrélation de back end, par exemple pour prendre en charge la corrélation de back end pour les anciens navigateurs Web ou pour prendre en charge la corrélation de back end entre les origines. La plupart des corrélations dorsales sont automatiques. Pour étendre la couverture de corrélation d'arrière-plan, voir les étapes suivantes. Ces étapes sont facultatives. Vous pouvez les suivre dans l'ordre, lorsque vous identifiez une corrélation d'arrière-plan manquante.

Instana permet d'établir un lien entre l'activité du backend et celle du site web lorsque l'activité du backend est suivie. Comme condition préalable à la corrélation, vous devez activer la collecte de données d'arrière-plan, également connue sous le nom de "traçage". Pour activer le traçage, consultez la section « Traçage » dans Instana.

Instana Le script de surveillance de sites web prend en charge les types suivants de technologies de corrélation backend :

• Instana traçage
• W3C contexte de trace

Si vous souhaitez continuer à en apprendre davantage sur le processus de corrélation d'arrière-plan, vous devez bien comprendre le concept des origines. L'article de la FAQ « Instana » explique ce que vous devez savoir sur les origines pour bien comprendre les étapes suivantes :

La corrélation entre les utilisations de ` fetchAPIXMLHttpRequest ` fonctionne de manière fiable pour tous les appels de même origine. En raison de la politique du même domaine et des interactions inter-domaines, la corrélation automatique entre les appels et le backend d' HTTP s n'est pas possible.

Pour permettre la corrélation en arrière-plan lorsque plusieurs origines sont impliquées, on utilise le partage de ressources entre origines ( CORS ). CORS est un mécanisme qui définit des exceptions contrôlées au mécanisme de sécurité de la politique de même origine. Pour résoudre les restrictions imposées par la règle de même origine, consultez la capture d'écran suivante qui décrit ce qui est requis.

Les traces dorsales et les chargements de page de site Web, c'est-à-dire l'extraction des fichiers HTML initiaux, sont automatiquement corrélés pour les navigateurs Web qui prennent en charge Server-Timing. En exposant manuellement l'ID de trace du chargement de page initial dans l'agent JavaScript, il est possible d'activer la corrélation de back end pour tous les navigateurs Web. Pour activer la corrélation de back end, vous devez effectuer les étapes suivantes:

1. Extrayez l'ID de trace sur le système dorsal.
2. Convertir l'identifiant de trace dans l'extrait de code JavaScript d' Instana

// 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>

La corrélation du backend pour les ressources ou les actifs, tels que les images, JavaScript, et les fichiers CSS, est automatique :

• Navigateurs Web Support Serveur-Calendrier.
• Ressources ou actifs qui sont servis à partir de la même origine que le document HTML.

Pour déverrouiller la corrélation de back end lorsque plusieurs origines sont impliquées, utilisez l'en-tête de réponse Timing-Allow-Origin. Cet en-tête indique au serveur timing allow check de mettre les données à disposition sur JavaScript et de les transmettre à l'agent Instana JavaScript.

Pour déverrouiller les fonctions de corrélation d'arrière-plan pour les ressources qui sont extraites d'origines différentes de l'origine du document HTML, voir la capture d'écran suivante:

Si le serveur backend prend en charge la fonctionnalité « OpenTelemetry », vous pouvez compléter l'extrait de code Instana JavaScript en y ajoutant un appel à la méthode ineum('enableW3CHeaders', true);API. Si le serveur intègre les traceparent métadonnées dans la page HTML, l'agent Instana JavaScript peut analyser le contenu et parent-id l'utiliser comme backendTraceId données pour la balise pageLoad.

Lors d'un appel XMLHttpRequestfetch ou d'une requête, les traceparent en-têtes et tracestate sont générés et ajoutés aux en-têtes d'origine de HTTP. tracestate est utilisé comme backendTraceId balise XHR envoyée au serveur Instana.