You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
short_description: "Surveillez les erreurs Amazon\_API\_Gateway."
22
+
public_title: Intégration Datadog/Amazon API Gateway
23
+
short_description: Surveillez les erreurs Amazon API Gateway.
22
24
version: '1.0'
23
25
---
26
+
24
27
## Présentation
25
28
26
29
Amazon API Gateway est un service entièrement géré qui permet aux développeurs de créer, publier, gérer, surveiller et sécuriser facilement des API quelque soit l'échelle.
@@ -35,7 +38,7 @@ Si vous ne l'avez pas déjà fait, configurez d'abord [l'intégration Amazon We
35
38
36
39
### Collecte de métriques
37
40
38
-
1.Dans le [carré d'intégration AWS][2], assurez-vous que l'option `API Gateway` est cochée dans la section concernant la collecte des métriques.
41
+
1.Sur la [page de l'intégration AWS][2], vérifiez que `API Gateway` est activé dans l'onglet `Metric Collection`.
39
42
40
43
2. Ajoutez les autorisations suivantes à votre [stratégie IAM Datadog][3] afin de récupérer les tags personnalisés appliqués aux étapes API Gateway :
41
44
@@ -44,6 +47,8 @@ Si vous ne l'avez pas déjà fait, configurez d'abord [l'intégration Amazon We
44
47
45
48
3. Configurez l'[intégration Datadog/AWS API Gateway][4].
46
49
50
+
**Remarque** : si vous avez activé les métriques CloudWatch détaillées, vous devez les activer pour toutes les ressources ou toutes les routes d'une étape. Sinon, les valeurs agrégées dans Datadog seront incorrectes.
51
+
47
52
### Collecte de logs
48
53
49
54
Pour activer la journalisation API Gateway :
@@ -52,7 +57,7 @@ Pour activer la journalisation API Gateway :
52
57
2. Sélectionnez l'API souhaitée et accédez à la section Stages.
53
58
3. Dans l'onglet **Logs**, activez **Enable CloudWatch Logs** et **Enable Access Logging**.
54
59
4. Sélectionnez le niveau `INFO` afin de récupérer l'ensemble des requêtes.
55
-
5. Assurez-vous d'inclure `apigateway` dans le nom de votre **groupe Cloudwatch**.
60
+
5. Assurez-vous que le nom de votre **groupe CloudWatch** commence par `api-gateway`.
56
61
6. Sélectionnez le format JSON (les formats CLF et CSV sont également pris en charge), et ajoutez ce qui suit dans le champ **Log format** :
57
62
58
63
```text
@@ -73,10 +78,8 @@ Pour activer la journalisation API Gateway :
73
78
#### Envoyer des logs à Datadog
74
79
75
80
1. Si vous ne l'avez pas déjà fait, configurez la [fonction AWS Lambda de collecte de logs avec Datadog][5].
76
-
2. Une fois la fonction Lambda installée, ajoutez manuellement un déclencheur dans la console AWS sur le groupe de logs Cloudwatch qui contient vos logs API Gateway :
77
-
{{< img src="integrations/amazon_cloudwatch/cloudwatch_log_collection_1.png" alt="groupes de logs cloudwatch" popup="true" style="width:70%;">}}
78
-
Sélectionnez le groupe de logs CloudWatch correspondant, ajoutez un nom de filtre (vous pouvez toutefois laisser le filtre vide) et ajoutez le déclencheur :
2. Une fois la fonction Lambda installée, ajoutez manuellement un déclencheur sur le groupe de logs CloudWatch qui contient vos logs API Gateway depuis la console AWS.
82
+
Sélectionnez le groupe de logs CloudWatch correspondant, ajoutez un nom de filtre (vous pouvez toutefois laisser le filtre vide) et ajoutez le déclencheur.
80
83
81
84
Accédez ensuite à la [section Log de Datadog][6] pour commencer à explorer vos logs !
82
85
@@ -86,7 +89,7 @@ Accédez ensuite à la [section Log de Datadog][6] pour commencer à explorer vo
86
89
{{< get-metrics-from-git "amazon_api_gateway" >}}
87
90
88
91
89
-
Chacune des métriques récupérées à partir d'AWS se verra assigner les mêmes tags que ceux qui apparaissent dans la console AWS, y compris, mais sans s'y limiter, le hostname et les groupes de sécurité.
92
+
Chacune des métriques récupérées à partir d'AWS se voit assigner les mêmes tags que ceux qui apparaissent dans la console AWS, y compris, mais sans s'y limiter, le hostname et les groupes de sécurité.
90
93
91
94
### Événements
92
95
@@ -101,10 +104,10 @@ L'intégration AWS API Gateway n'inclut aucun check de service.
description: Découvrez les options de configuration avancées disponibles pour votre
5
3
configuration React Native.
6
4
further_reading:
@@ -15,7 +13,36 @@ title: Configuration avancée du RUM pour React Native
15
13
---
16
14
## Présentation
17
15
18
-
Si vous n'avez pas encore installé le SDK, consultez les [instructions de configuration intégrées à l'application][1] ou reportez-vous à la [documentation sur la configuration du RUM pour React Native][2].
16
+
Si vous n'avez pas encore installé le SDK, consultez les [instructions de configuration dans l'application][1] ou reportez-vous à la [documentation sur la configuration du RUM pour React Native][2].
17
+
18
+
## Tests avec Jest
19
+
20
+
Pour tester des applications avec `'@datadog/mobile-react-native'`, vous devrez potentiellement suivre des étapes supplémentaires. En effet, les environnements de testing ne comportent pas de modules Native.
21
+
22
+
Datadog propose des simulations du package `'@datadog/mobile-react-native'`. Pour les utiliser avec [Jest][4], ajoutez ce qui suit dans le fichier de configuration de Jest :
Si vous initialisez le SDK avec le composant `DatadogProvider`, le suivi automatique des interactions, erreurs et ressources est désactivé dans vos tests.
31
+
32
+
Toutes les méthodes de SDK sont simulées à l'aide de `jest.fn()`. Vous pouvez donc vérifier si une méthode de SDK Datadog a été appelée :
Pour modifier les attributs d'un événement RUM avant de l'envoyer à Datadog, ou pour ignorer complètement un événement, utilisez l'API Event Mappers lors de la configuration du SDK RUM React Native :
116
+
117
+
```javascript
118
+
constconfig=newDdSdkReactNativeConfiguration(
119
+
'<TOKEN_CLIENT>',
120
+
'<NOM_ENVIRONNEMENT>',
121
+
'<ID_APPLICATION_RUM>',
122
+
true, // surveiller les interactions utilisateur (comme les boutons touchés)
123
+
true, // surveiller les ressources XHR
124
+
true// surveiller les erreurs
125
+
);
126
+
config.logEventMapper=event=>event;
127
+
config.errorEventMapper=event=>event;
128
+
config.resourceEventMapper=event=>event;
129
+
config.actionEventMapper=event=>event;
130
+
```
131
+
132
+
Chaque mapper correspond à une fonction dotée d'une signature `(T) -> T?`, où `T` est un type d'événement RUM concret. Cela permet de modifier des parties de l'événement avant son envoi, ou de l'ignorer complètement.
133
+
134
+
Par exemple, pour censurer des informations sensibles du `message` d'une erreur RUM, implémentez une fonction `redacted` personnalisée et utilisez-la dans `errorEventMapper` :
135
+
136
+
```javascript
137
+
config.errorEventMapper=event=> {
138
+
event.message=redacted(event.message);
139
+
returnevent;
140
+
};
141
+
```
142
+
143
+
Lorsque le mapper d'erreur, de ressource ou d'action renvoie la valeur `null`, l'événement est complètement ignoré et n'est donc pas envoyé à Datadog.
144
+
145
+
Selon le type de l'événement, seules certaines propriétés peuvent être modifiées :
146
+
147
+
| Type d'événement | Clé d'attribut | Description |
| LogEvent |`logEvent.additionalInformation.userInfo`| Contient les informations globales sur l'utilisateur définies par `DdSdkReactNative.setUser`. |
164
+
||`logEvent.additionalInformation.attributes`| Contient les attributs globaux définis par `DdSdkReactNative.setAttributes`. |
165
+
| ActionEvent |`actionEvent.actionContext`|[GestureResponderEvent][5] correspond à l'action ou à `undefined`. |
166
+
||`actionEvent.additionalInformation.userInfo`| Contient les informations globales sur l'utilisateur définies par `DdSdkReactNative.setUser`. |
167
+
||`actionEvent.additionalInformation.attributes`| Contient les attributs globaux définis par `DdSdkReactNative.setAttributes`. |
168
+
| ErrorEvent |`errorEvent.additionalInformation.userInfo`| Contient les informations globales sur l'utilisateur définies par `DdSdkReactNative.setUser`. |
169
+
||`errorEvent.additionalInformation.attributes`| Contient les attributs globaux définis par `DdSdkReactNative.setAttributes`. |
170
+
| ResourceEvent |`resourceEvent.resourceContext`|[XMLHttpRequest][6] correspond à la ressource ou à `undefined`. |
171
+
||`resourceEvent.additionalInformation.userInfo`| Contient les informations globales sur l'utilisateur définies par `DdSdkReactNative.setUser`. |
172
+
||`resourceEvent.additionalInformation.attributes`| Contient les attributs globaux définis par `DdSdkReactNative.setAttributes`. |
173
+
86
174
## Durées des ressources
87
175
88
176
Grâce au suivi des ressources, vous pouvez recueillir les durées suivantes :
title: Installer l'Agent de trace depuis les sources
6
+
---
7
+
8
+
## Installation depuis les sources
9
+
10
+
1. Installez `Go 1.11+`. Pour en savoir plus, suivez le guide détaillé disponible sur le [site Web officiel de Go][1] (en anglais).
11
+
2. Dupliquez le [référentiel de l'Agent Datadog][2].
12
+
3. Exécutez la commande suivante à la racine du référentiel `datadog-agent` :
13
+
```bash
14
+
go install ./cmd/trace-agent
15
+
```
16
+
17
+
4. Exécutez l'Agent à l'aide de `trace-agent` (en supposant que le chemin `$GOPATH/bin` se trouve dans le `$PATH` de votre système).
18
+
19
+
### Dépannage
20
+
21
+
Consultez la sortie de l'Agent ou ses logs (`/var/log/datadog/trace-agent.log` sous Linux) pour vérifier que les traces ne comportent pas d'erreur et qu'elles parviennent à communiquer avec l'API Datadog.
0 commit comments