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

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 xray.Handler pour instrumenter les demandes HTTP entrantes. Le kit SDK X-Ray pour Go implémente la bibliothèque Go standardhttp.Handlerdans l'interface dexray.Handlerpour intercepter les requêtes Web. La classe xray.Handler englobe l'élément http.Handler fourni avec xray.Capture en utilisant le contexte de la demande, en analysant les en-têtes entrants et en ajoutant des en-têtes de réponse si nécessaire, puis elle définit les champs de suivi propres à HTTP.

Lorsque vous utilisez cette classe pour traiter les demandes et les réponses HTTP, le kit SDK X-Ray pour Go crée un segment pour chaque demande échantillonnée. 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.

Note

PourAWS Lambda, Lambda crée un segment pour chaque demande échantillonnée. Pour plus d'informations, consultez AWS Lambda et AWS X-Ray.

L'exemple suivant intercepte les demandes sur le port 8000 et renvoie « Hello ! » comme réponse. Il crée le segment myApp et instrumente des appels par le biais de n'importe quelle application.

Exemple main.go

func main() {
  http.Handle("/", xray.Handler(xray.NewFixedSegmentNamer("MyApp"), http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("Hello!"))
  })))

  http.ListenAndServe(":8000", nil)
}

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é).

Demandes transférées

Si un équilibreur de charge ou un autre intermédiaire transmet une demande à votre application, X-Ray prend l'adresse IP du client à partir duX-Forwarded-Foren-tête dans la requête au lieu de l'adresse IP source dans le paquet IP. L'adresse IP du client enregistrée pour une demande transférée peut être falsifié, elle ne doit donc pas être fiable.

Lorsqu'une demande est transférée, le kit SDK définit un champ supplémentaire dans le segment pour indiquer cela. Si le segment contient le champx_forwarded_forréglé surtrue, l'adresse IP du client a été extraite duX-Forwarded-Fordans la demande HTTP.

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

• HTTP method (Méthode HTTP)— GET, POST, PUT, DELETE, etc.

• Adresse client— Adresse IP du client qui a envoyé la demande.

• Code de réponse— Code réponse HTTP pour la demande terminée.

• Timing (Durée)— Heure de début (lorsque la demande est reçue) et l'heure de fin (lorsque la réponse est envoyée).

• Agent utilisateur— Leuser-agentde la demande.

• Longueur du contenu— Lecontent-lengthde la réponse.

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 etAWSles ressources que votre application utilise. Lorsque le kit SDK X-Ray génère des segments pour les demandes entrantes, il enregistre le nom du service de votre application dans leNom de champ.

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 seule application peut servir les 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 créez le gestionnaire, comme indiqué dans les sections précédentes.

Note

Vous pouvez remplacer le nom de service par défaut que vous définissez avec la AWS_XRAY_TRACING_NAMEvariable d'environnementVariables d’environnement.

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 des segments de façon dynamique, utilisez NewDynamicSegmentNamer pour configurer le nom par défaut et le modèle correspondant.

Exemple main.go

Si le nom d'hôte dans la demande correspond au modèle *.example.com, utilisez le nom d'hôte. Dans le cas contraire, utilisez MyApp.

func main() {
  http.Handle("/", xray.Handler(xray.NewDynamicSegmentNamer("MyApp", "*.example.com"), http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("Hello!"))
  })))

  http.ListenAndServe(":8000", nil)
}