Instrumentation des demandes HTTP entrantes avec le kit SDK X-Ray pour .NET

Vous pouvez utiliser le kit SDK X-Ray pour suivre les demandes HTTP entrantes servies par votre application sur une instance EC2 dans Amazon EC2,AWS Elastic Beanstalk, ou Amazon ECS.

Utilisez un gestionnaire de messages pour instrumenter les demandes HTTP entrantes. Lorsque vous ajoutez le gestionnaire de messages X-Ray à votre application, le kit SDK X-Ray pour .NET crée un segment pour chaque exemple de demande. Ce segment comprend la durée, la méthode et l'état de la demande HTTP. L'instrumentation supplémentaire crée des sous-segments sur ce segment.

Chaque segment possède un nom qui identifie votre application dans la carte de service. Le segment peut être nommé de manière statique ou vous pouvez configurer le SDK pour le nommer dynamiquement en fonction de l'en-tête de l'hôte dans la demande entrante. La dénomination dynamique permet de regrouper les traces en fonction du nom de domaine dans la demande et d'appliquer un nom par défaut si le nom ne correspond pas à un modèle attendu (par exemple, si l'en-tête de l'hôte est falsifié).

Le gestionnaire de messages crée un segment pour chaque demande entrante avec un bloc http contenant les informations suivantes :

Instrumentation des demandes entrantes (.NET)

Pour instrumenter des demandes servies par votre application, appelez RegisterXRay dans la méthode Init de votre fichier global.asax.

using System.Web.Http;
using Amazon.XRay.Recorder.Handlers.AspNet;

namespace SampleEBWebApplication
{
  public class MvcApplication : System.Web.HttpApplication
  {
    public override void Init()
    {
      base.Init();
      AWSXRayASPNET.RegisterXRay(this, "MyApp");
    }
  }
}

Instrumentation des demandes entrantes (.NET Core)

Pour instrumenter des demandes servies par votre application, appelezUseXRayavant tout autre intergiciel dans leConfigurede votre classe Startup comme idéalement le middleware X-Ray devrait être le premier intergiciel à traiter la demande et le dernier intergiciel à traiter la réponse dans le pipeline.

using Microsoft.AspNetCore.Builder;

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
  {
    app.UseXRay("MyApp");
    // additional middleware
    ...
  }

using Microsoft.AspNetCore.Builder;

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
  {
    app.UseExceptionHandler("/Error");
    app.UseXRay("MyApp");
    // additional middleware
    ...
  }

La méthode UseXRay peut également accepter un objet de configuration comme deuxième argument.

app.UseXRay("MyApp", configuration);

Configuration d'une stratégie d'attribution de noms de segment

AWS X-Rayutilise unService namepour identifier votre application et la distinguer des autres applications, bases de données, API externes etAWSressources que votre application utilise. Lorsque le SDK X-Ray génère des segments pour les demandes entrantes, il enregistre le nom du service de votre application dans lechamp de nom.

Le SDK X-Ray peut nommer des segments après le nom d'hôte dans l'en-tête de la requête HTTP. Toutefois, cet en-tête peut être falsifié, ce qui peut entraîner des nœuds inattendus dans votre carte de service. Pour empêcher le SDK de nommer incorrectement les segments en raison de demandes comportant des en-têtes d'hôte falsifiés, vous devez spécifier un nom par défaut pour les demandes entrantes.

Si votre application répond à des demandes pour plusieurs domaines, vous pouvez configurer le SDK pour qu'il utilise une stratégie de dénomination dynamique qui reflète cela dans les noms de segments. Une stratégie de dénomination dynamique permet au SDK d'utiliser le nom d'hôte pour les demandes correspondant à un modèle attendu, et d'appliquer le nom par défaut aux demandes qui ne le font pas.

Par exemple, une application unique peut servir des demandes à trois sous-domaines :www.example.com,api.example.com, etstatic.example.com. Vous pouvez utiliser une stratégie de dénomination dynamique avec le modèle*.example.compour identifier les segments de chaque sous-domaine portant un nom différent, ce qui entraîne trois nœuds de service sur la carte de service. Si votre application reçoit des demandes dont le nom d'hôte ne correspond pas au modèle, vous verrez un quatrième nœud sur la carte de service avec un nom de secours que vous spécifiez.

Pour utiliser le même nom pour tous les segments de la demande, spécifiez le nom de votre application lorsque vous initialisez le gestionnaire de messages, comme indiqué dans la section précédente. L'effet est le même que celui obtenu en créant une FixedSegmentNamingStrategy et en la transmettant à la méthode RegisterXRay.

AWSXRayASPNET.RegisterXRay(this, new FixedSegmentNamingStrategy("MyApp"));

Une stratégie d'attribution de noms dynamique définit un modèle auquel doivent correspondre les noms d'hôte et un nom par défaut à utiliser si le nom d'hôte de la demande HTTP ne correspond pas au modèle. Pour nommer dynamiquement des segments, créez une stratégie DynamicSegmentNamingStrategy et transmettez-la à la méthode RegisterXRay.

AWSXRayASPNET.RegisterXRay(this, new DynamicSegmentNamingStrategy("MyApp", "*.example.com"));