AWS X-Ray - Manuel du développeur
AWS X-Ray
Manuel du développeur
AWS X-Ray Manuel du développeur
AWS X-Ray: Manuel du développeur
Copyright © 2017 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.
Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner
that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not
owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by
Amazon.
AWS X-Ray Manuel du développeur
Table of Contents
Présentation de AWS X-Ray ................................................................................................................ 1
Utilisation de X-Ray ............................................................................................................................ 2
Langages pris en charge et infrastructures ..................................................................................... 2
Services AWS pris en charge ....................................................................................................... 3
Modifications de code et de configuration ....................................................................................... 4
Mise en route avec AWS X-Ray ........................................................................................................... 5
Prérequis ................................................................................................................................... 6
Déployez sur Elastic Beanstalk et générez des données de suivi ....................................................... 6
Affichez le graphique de services dans la console X-Ray .................................................................. 7
Explorez l'exemple d'application .................................................................................................... 9
Nettoyage ................................................................................................................................ 12
Etapes suivantes ...................................................................................................................... 13
Concepts ......................................................................................................................................... 14
Segments ................................................................................................................................ 14
Sous-segments ......................................................................................................................... 15
Graphique de services ............................................................................................................... 15
Suivis ...................................................................................................................................... 15
Echantillonnage ........................................................................................................................ 15
En-tête de suivi ........................................................................................................................ 16
Expressions de filtrage .............................................................................................................. 16
La console AWS X-Ray ..................................................................................................................... 17
Affichage de la cartographie des services ..................................................................................... 18
Affichage des suivis .................................................................................................................. 20
Affichage des détails d'un segment .............................................................................................. 23
Affichage des détails d'un sous-segment ...................................................................................... 24
Utilisation des expressions de filtrage .......................................................................................... 26
Lien profond ............................................................................................................................. 27
L'API AWS X-Ray ............................................................................................................................. 29
Utilisation de l'API AWS X-Ray avec l'interface de ligne de commande AWS ...................................... 30
Prérequis ......................................................................................................................... 30
Générez des données de suivi ........................................................................................... 30
Utilisez l'API X-Ray ........................................................................................................... 31
Nettoyage ........................................................................................................................ 33
Chargement du document de segment ......................................................................................... 33
Envoi de documents de segment au démon X-Ray ........................................................................ 35
Documents de segment ............................................................................................................. 35
Champs de segment ......................................................................................................... 36
Sous-segments ................................................................................................................. 37
Données de demande HTTP .............................................................................................. 40
Annotations ...................................................................................................................... 42
Metadonnées .................................................................................................................... 43
Données de ressources AWS ............................................................................................. 44
Erreurs et exceptions ........................................................................................................ 45
Requêtes SQL .................................................................................................................. 46
Travail avec Java .............................................................................................................................. 48
Prérequis ................................................................................................................................. 49
Gestion des dépendances .......................................................................................................... 50
Configuration ............................................................................................................................ 51
Plug-ins de service ........................................................................................................... 51
Règles d'échantillonnage .................................................................................................... 53
Journalisation ................................................................................................................... 55
Variables d'environnement .................................................................................................. 55
Exemple d'application ................................................................................................................ 55
Instrumentation manuelle des clients de kit de développement logiciel AWS ............................... 58
iii
AWS X-Ray Manuel du développeur
Création de sous-segments supplémentaires ......................................................................... 58
Enregistrement des annotations, des métadonnées et des ID utilisateur ..................................... 59
Instrumentation des appels HTTP sortants ............................................................................ 60
Instrumentation d'appels vers une base de données PostgreSQL ............................................. 60
Demandes entrantes ................................................................................................................. 63
Ajout d'un filtre de suivi à votre application (Tomcat) .............................................................. 64
Ajout d'un filtre de suivi à votre application (Spring) ................................................................ 64
Configuration d'une stratégie d'attribution de noms de segment ................................................ 64
Clients des kits de développement logiciel AWS ............................................................................ 66
Appels HTTP sortants ............................................................................................................... 67
Requêtes SQL .......................................................................................................................... 69
Sous-segments personnalisés ..................................................................................................... 70
Annotations et métadonnées ...................................................................................................... 71
Enregistrement des annotations avec le Kit SDK X-Ray pour Java ............................................ 72
Enregistrement des métadonnées avec le Kit SDK X-Ray pour Java ......................................... 73
Enregistrement des ID utilisateur avec le Kit SDK X-Ray pour Java .......................................... 74
Utilisation de Node.js ......................................................................................................................... 76
Prérequis ................................................................................................................................. 77
Gestion des dépendances .......................................................................................................... 77
Configuration ............................................................................................................................ 78
Plug-ins de service ........................................................................................................... 78
Règles d'échantillonnage .................................................................................................... 79
Journalisation ................................................................................................................... 79
Variables d'environnement .................................................................................................. 80
Demandes entrantes ................................................................................................................. 80
Ajout d'un filtre de suivi à votre application ........................................................................... 81
Configuration d'une stratégie d'attribution de noms de segment ................................................ 81
Clients des kits de développement logiciel AWS ............................................................................ 82
Appels HTTP sortants ............................................................................................................... 84
Requêtes SQL .......................................................................................................................... 85
Sous-segments personnalisés ..................................................................................................... 85
Utilisation de .NET ............................................................................................................................ 87
Prérequis ................................................................................................................................. 87
Ajout de Kit SDK X-Ray pour .NET à votre application .................................................................... 88
Configuration ............................................................................................................................ 88
Plug-ins ........................................................................................................................... 88
Règles d'échantillonnage .................................................................................................... 88
Journalisation ................................................................................................................... 89
Variables d'environnement .................................................................................................. 90
Demandes entrantes ................................................................................................................. 90
Ajout d'un gestionnaire de messages de suivi à la configuration HTTP de votre application ............ 91
Ajout d'un gestionnaire de messages de suivi à la configuration globale de votre application .......... 91
Configuration d'une stratégie d'attribution de noms de segment ................................................ 92
Clients des kits de développement logiciel AWS ............................................................................ 93
Appels HTTP sortants ............................................................................................................... 94
Requêtes SQL .......................................................................................................................... 95
Sous-segments personnalisés ..................................................................................................... 96
Le démon X-Ray .............................................................................................................................. 97
Octroi de l'autorisation au démon pour envoyer des données à X-Ray ............................................... 98
Journaux du démon X-Ray ......................................................................................................... 99
Configuration du démon ............................................................................................................. 99
Exécutez le démon en local ...................................................................................................... 100
Exécution du démon X-Ray sous Linux .............................................................................. 101
Exécution du démon X-Ray sous Windows ......................................................................... 101
Sur Elastic Beanstalk ............................................................................................................... 101
Utilisation de l'intégration X-Ray d'Elastic Beanstalk pour exécuter le démon X-Ray .................... 102
Téléchargement et exécution du Démon X-Ray manuellement (avancé) ................................... 103
iv
AWS X-Ray Manuel du développeur
Sur Amazon EC2 .................................................................................................................... 104
Sur Amazon ECS .................................................................................................................... 105
Intégration de AWS X-Ray avec les services AWS ............................................................................... 107
Elastic Load Balancing ............................................................................................................. 107
AmazonAPIGateway .............................................................................................................. 108
Amazon Elastic Compute Cloud ................................................................................................ 108
AWS Elastic Beanstalk ............................................................................................................. 108
v
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
1
/
113
100%
