Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# X-Ray exemples utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with X-Ray.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `batch-traces-get`
L'exemple de code suivant montre comment utiliser`batch-traces-get`.
**AWS CLI**
**Pour obtenir une liste des suivis**
L’exemple `batch-get-traces` suivant extrait une liste des suivis spécifiés par un ID. Le suivi complet inclut un document pour chaque segment, compilé à partir de l’ensemble des documents de segments reçus pour le même ID de suivi.
```
aws xray batch-get-traces \
--trace-ids {{1-5d82881a-0a9126e92a73e971eed891b9}}
```
Sortie :
```
{
"Traces": [
{
"Id": "1-5d82881a-0a9126e92a73e971eed891b9",
"Duration": 0.232,
"Segments": [
{
"Id": "54aff5735b12dd28",
"Document": "{\"id\":\"54aff5735b12dd28\",\"name\":\"Scorekeep\",\"start_time\":1.568835610432E9,\"end_time\":1.568835610664E9,\"http\":{\"request\":{\"url\":\"http://scorekeep-env-1.m4fg2pfzpv.us-east-2.elasticbeanstalk.com/api/user\",\"method\":\"POST\",\"user_agent\":\"curl/7.59.0\",\"client_ip\":\"52.95.4.28\",\"x_forwarded_for\":true},\"response\":{\"status\":200}},\"aws\":{\"elastic_beanstalk\":{\"version_label\":\"Sample Application-1\",\"deployment_id\":3,\"environment_name\":\"Scorekeep-env-1\"},\"ec2\":{\"availability_zone\":\"us-east-2b\",\"instance_id\":\"i-0e3cf4d2de0f3f37a\"},\"xray\":{\"sdk_version\":\"1.1.0\",\"sdk\":\"X-Ray for Java\"}},\"service\":{\"runtime\":\"OpenJDK 64-Bit Server VM\",\"runtime_version\":\"1.8.0_222\"},\"trace_id\":\"1-5d82881a-0a9126e92a73e971eed891b9\",\"origin\":\"AWS::ElasticBeanstalk::Environment\",\"subsegments\":[{\"id\":\"2d6900034ccfe558\",\"name\":\"DynamoDB\",\"start_time\":1.568835610658E9,\"end_time\":1.568835610664E9,\"http\":{\"response\":{\"status\":200,\"content_length\":61}},\"aws\":{\"table_name\":\"scorekeep-user\",\"operation\":\"UpdateItem\",\"request_id\":\"TPEIDNDUROMLPOV17U4A79555NVV4KQNSO5AEMVJF66Q9ASUAAJG\",\"resource_names\":[\"scorekeep-user\"]},\"namespace\":\"aws\"}]}"
},
{
"Id": "0f278b6334c34e6b",
"Document": "{\"id\":\"0f278b6334c34e6b\",\"name\":\"DynamoDB\",\"start_time\":1.568835610658E9,\"end_time\":1.568835610664E9,\"parent_id\":\"2d6900034ccfe558\",\"inferred\":true,\"http\":{\"response\":{\"status\":200,\"content_length\":61}},\"aws\":{\"table_name\":\"scorekeep-user\",\"operation\":\"UpdateItem\",\"request_id\":\"TPEIDNDUROMLPOV17U4A79555NVV4KQNSO5AEMVJF66Q9ASUAAJG\",\"resource_names\":[\"scorekeep-user\"]},\"trace_id\":\"1-5d82881a-0a9126e92a73e971eed891b9\",\"origin\":\"AWS::DynamoDB::Table\"}"
}
]
}
],
"UnprocessedTraceIds": []
}
```
Pour plus d'informations, consultez la section [Utilisation de l' AWS X-Ray API avec la AWS CLI](https://docs.aws.amazon.com/xray/latest/devguide/xray-api-tutorial.html) dans le *manuel du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [BatchTracesGet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/batch-traces-get.html)à la section *Référence des AWS CLI commandes*.
### `créer un groupe`
L'exemple de code suivant montre comment utiliser`create-group`.
**AWS CLI**
**Pour créer un groupe**
L’exemple `create-group` suivant crée une ressource de groupe nommée `AdminGroup`. Le groupe obtient une expression de filtre qui définit les critères du groupe sous la forme d’un segment lié à un service spécifique à l’origine d’une panne ou d’une erreur.
```
aws xray create-group \
--group-name {{"AdminGroup"}} \
--filter-expression "service(\"mydomain.com\") {fault OR error}"
```
Sortie :
```
{
"GroupName": "AdminGroup",
"GroupARN": "arn:aws:xray:us-west-2:123456789012:group/AdminGroup/123456789",
"FilterExpression": "service(\"mydomain.com\") {fault OR error}"
}
```
Pour plus d'informations, consultez [la section Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l' AWS X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html#xray-api-configuration-sampling) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/create-group.html)à la section *Référence des AWS CLI commandes*.
### `créer une règle d'échantillonnage`
L'exemple de code suivant montre comment utiliser`create-sampling-rule`.
**AWS CLI**
**Pour créer une règle d’échantillonnage**
L’exemple `create-sampling-rule` suivant crée une règle pour contrôler le comportement d’échantillonnage pour les applications instrumentées. Les règles sont fournies par un fichier JSON. La majorité des champs de règle d’échantillonnage sont obligatoires pour créer la règle.
```
aws xray create-sampling-rule \
--cli-input-json {{file://9000-base-scorekeep.json}}
```
Contenu de `9000-base-scorekeep.json` :
```
{
"SamplingRule": {
"RuleName": "base-scorekeep",
"ResourceARN": "*",
"Priority": 9000,
"FixedRate": 0.1,
"ReservoirSize": 5,
"ServiceName": "Scorekeep",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"Version": 1
}
}
```
Sortie :
```
{
"SamplingRuleRecord": {
"SamplingRule": {
"RuleName": "base-scorekeep",
"RuleARN": "arn:aws:xray:us-west-2:123456789012:sampling-rule/base-scorekeep",
"ResourceARN": "*",
"Priority": 9000,
"FixedRate": 0.1,
"ReservoirSize": 5,
"ServiceName": "Scorekeep",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"Version": 1,
"Attributes": {}
},
"CreatedAt": 1530574410.0,
"ModifiedAt": 1530574410.0
}
}
```
Pour plus d'informations, consultez [la section Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l' AWS X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html#xray-api-configuration-sampling) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [CreateSamplingRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/create-sampling-rule.html)à la section *Référence des AWS CLI commandes*.
### `supprime-groupe`
L'exemple de code suivant montre comment utiliser`delete-group`.
**AWS CLI**
**Pour supprimer un groupe**
L’exemple `delete-group` suivant supprime la ressource de groupe spécifiée.
```
aws xray delete-group \
--group-name {{"AdminGroup"}} \
--group-arn {{"arn:aws:xray:us-east-2:123456789012:group/AdminGroup/123456789"}}
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez [la section Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l' AWS X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html#xray-api-configuration-sampling) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/delete-group.html)à la section *Référence des AWS CLI commandes*.
### `supprime-règle d'échantillonnage`
L'exemple de code suivant montre comment utiliser`delete-sampling-rule`.
**AWS CLI**
**Pour supprimer une règle d’échantillonnage**
L’exemple `delete-sampling-rule` suivant supprime la règle d’échantillonnage spécifiée. Vous pouvez spécifier le groupe en utilisant le nom ou l’ARN du groupe.
```
aws xray delete-sampling-rule \
--rule-name {{polling-scorekeep}}
```
Sortie :
```
{
"SamplingRuleRecord": {
"SamplingRule": {
"RuleName": "polling-scorekeep",
"RuleARN": "arn:aws:xray:us-west-2:123456789012:sampling-rule/polling-scorekeep",
"ResourceARN": "*",
"Priority": 5000,
"FixedRate": 0.003,
"ReservoirSize": 0,
"ServiceName": "Scorekeep",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "GET",
"URLPath": "/api/state/*",
"Version": 1,
"Attributes": {}
},
"CreatedAt": 1530574399.0,
"ModifiedAt": 1530574399.0
}
}
```
Pour plus d'informations, consultez [la section Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l' AWS X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html#xray-api-configuration-sampling) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteSamplingRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/delete-sampling-rule.html)à la section *Référence des AWS CLI commandes*.
### `get-encryption-config`
L'exemple de code suivant montre comment utiliser`get-encryption-config`.
**AWS CLI**
**Pour récupérer la configuration de chiffrement**
L'`get-encryption-config`exemple suivant permet de récupérer la configuration de chiffrement actuelle de vos AWS X-Ray données.
```
aws xray get-encryption-config
```
Sortie :
```
{
"EncryptionConfig": {
"KeyId": "ae4aa6d49-a4d8-9df9-a475-4ff6d7898456",
"Status": "ACTIVE",
"Type": "NONE"
}
}
```
Pour plus d'informations, consultez [la section Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l' AWS X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-encryption-config.html)à la section *Référence des AWS CLI commandes*.
### `get-group`
L'exemple de code suivant montre comment utiliser`get-group`.
**AWS CLI**
**Pour récupérer un groupe**
L’exemple `get-group` suivant affiche les détails sur la ressource de groupe spécifiée. Les détails incluent le nom du groupe, l’ARN du groupe et l’expression de filtre qui définit les critères pour ce groupe. Les groupes peuvent également être extraits par ARN.
```
aws xray get-group \
--group-name {{"AdminGroup"}}
```
Sortie :
```
{
"Group": [
{
"GroupName": "AdminGroup",
"GroupARN": "arn:aws:xray:us-west-2:123456789012:group/AdminGroup/123456789",
"FilterExpression": "service(\"mydomain.com\") {fault OR error}"
}
]
}
```
Pour plus d'informations, consultez [la section Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l' AWS X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html#xray-api-configuration-sampling) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-group.html)à la section *Référence des AWS CLI commandes*.
### `get-groups`
L'exemple de code suivant montre comment utiliser`get-groups`.
**AWS CLI**
**Pour récupérer tous les groupes**
L’exemple suivant affiche les détails de tous les groupes actifs.
```
aws xray get-groups
```
Sortie :
```
{
"Groups": [
{
"GroupName": "AdminGroup",
"GroupARN": "arn:aws:xray:us-west-2:123456789012:group/AdminGroup/123456789",
"FilterExpression": "service(\"example.com\") {fault OR error}"
},
{
"GroupName": "SDETGroup",
"GroupARN": "arn:aws:xray:us-west-2:123456789012:group/SDETGroup/987654321",
"FilterExpression": "responsetime > 2"
}
]
}
```
Pour plus d'informations, consultez [la section Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l' AWS X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html#xray-api-configuration-sampling) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-groups.html)à la section *Référence des AWS CLI commandes*.
### `get-sampling-rules`
L'exemple de code suivant montre comment utiliser`get-sampling-rules`.
**AWS CLI**
**Pour extraire toutes les règles d’échantillonnage**
L’exemple `get-sampling-rules` suivant affiche les détails de toutes les règles d’échantillonnage disponibles :
```
aws xray get-sampling-rules
```
Sortie :
```
{
"SamplingRuleRecords": [
{
"SamplingRule": {
"RuleName": "Default",
"RuleARN": "arn:aws:xray:us-east-1::sampling-rule/Default",
"ResourceARN": "*",
"Priority": 10000,
"FixedRate": 0.01,
"ReservoirSize": 0,
"ServiceName": "*",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"Version": 1,
"Attributes": {}
},
"CreatedAt": 0.0,
"ModifiedAt": 1530558121.0
},
{
"SamplingRule": {
"RuleName": "base-scorekeep",
"RuleARN": "arn:aws:xray:us-east-1::sampling-rule/base-scorekeep",
"ResourceARN": "*",
"Priority": 9000,
"FixedRate": 0.1,
"ReservoirSize": 2,
"ServiceName": "Scorekeep",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"Version": 1,
"Attributes": {}
},
"CreatedAt": 1530573954.0,
"ModifiedAt": 1530920505.0
},
{
"SamplingRule": {
"RuleName": "polling-scorekeep",
"RuleARN": "arn:aws:xray:us-east-1::sampling-rule/polling-scorekeep",
"ResourceARN": "*",
"Priority": 5000,
"FixedRate": 0.003,
"ReservoirSize": 0,
"ServiceName": "Scorekeep",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "GET",
"URLPath": "/api/state/*",
"Version": 1,
"Attributes": {}
},
"CreatedAt": 1530918163.0,
"ModifiedAt": 1530918163.0
}
]
}
```
Pour plus d'informations, consultez la section [Utilisation des règles d'échantillonnage avec l' X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-sampling.html) dans le *manuel du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetSamplingRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-sampling-rules.html)à la section *Référence des AWS CLI commandes*.
### `get-sampling-targets`
L'exemple de code suivant montre comment utiliser`get-sampling-targets`.
**AWS CLI**
**Pour demander un quota d’échantillonnage**
L’exemple `get-sampling-targets` suivant demande un quota d’échantillonnage pour les règles que le service utilise pour échantillonner les demandes. La réponse de AWS X-Ray inclut un quota qui peut être utilisé au lieu d'emprunter auprès du réservoir.
```
aws xray get-sampling-targets \
--sampling-statistics-documents '{{[ { "RuleName": "base-scorekeep", "ClientID": "ABCDEF1234567890ABCDEF10", "Timestamp": "2018-07-07T00:20:06, "RequestCount": 110, "SampledCount": 20, "BorrowCount": 10 }, { "RuleName": "polling-scorekeep", 31, "BorrowCount": 0 } ]}}'
```
Sortie :
```
{
"SamplingTargetDocuments": [
{
"RuleName": "base-scorekeep",
"FixedRate": 0.1,
"ReservoirQuota": 2,
"ReservoirQuotaTTL": 1530923107.0,
"Interval": 10
},
{
"RuleName": "polling-scorekeep",
"FixedRate": 0.003,
"ReservoirQuota": 0,
"ReservoirQuotaTTL": 1530923107.0,
"Interval": 10
}
],
"LastRuleModification": 1530920505.0,
"UnprocessedStatistics": []
}
```
Pour plus d'informations, consultez la section [Utilisation des règles d'échantillonnage avec l' X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-sampling.html) dans le *manuel du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetSamplingTargets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-sampling-targets.html)à la section *Référence des AWS CLI commandes*.
### `get-service-graph`
L'exemple de code suivant montre comment utiliser`get-service-graph`.
**AWS CLI**
**Pour obtenir un graphique de service**
L’exemple suivant affiche un document dans un délai spécifié qui décrit les services qui traitent les demandes entrantes et les services en aval qu’ils appellent comme résultat :
```
aws xray get-service-graph \
--start-time {{1568835392.0}}
--end-time {{1568835446.0}}
```
Sortie :
```
{
"Services": [
{
"ReferenceId": 0,
"Name": "Scorekeep",
"Names": [
"Scorekeep"
],
"Root": true,
"Type": "AWS::ElasticBeanstalk::Environment",
"State": "active",
"StartTime": 1568835392.0,
"EndTime": 1568835446.0,
"Edges": [
{
"ReferenceId": 1,
"StartTime": 1568835392.0,
"EndTime": 1568835446.0,
"SummaryStatistics": {
"OkCount": 14,
"ErrorStatistics": {
"ThrottleCount": 0,
"OtherCount": 0,
"TotalCount": 0
},
"FaultStatistics": {
"OtherCount": 0,
"TotalCount": 0
},
"TotalCount": 14,
"TotalResponseTime": 0.13
},
"ResponseTimeHistogram": [
{
"Value": 0.008,
"Count": 1
},
{
"Value": 0.005,
"Count": 7
},
{
"Value": 0.009,
"Count": 1
},
{
"Value": 0.021,
"Count": 1
},
{
"Value": 0.038,
"Count": 1
},
{
"Value": 0.007,
"Count": 1
},
{
"Value": 0.006,
"Count": 2
}
],
"Aliases": []
},
... TRUNCATED FOR BREVITY ...
]
}
],
"StartTime": 1568835392.0,
"EndTime": 1568835446.0,
"ContainsOldGroupVersions": false
}
```
Pour plus d'informations, consultez la section [Utilisation de l' AWS X-Ray API avec la AWS CLI](https://docs.aws.amazon.com/xray/latest/devguide/xray-api-tutorial.html) dans le *manuel du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetServiceGraph](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-service-graph.html)à la section *Référence des AWS CLI commandes*.
### `résumés get-trace`
L'exemple de code suivant montre comment utiliser`get-trace-summaries`.
**AWS CLI**
**Pour obtenir un résumé des suivis**
L’exemple `get-trace-summaries` suivant récupère les ID et les métadonnées pour les suivis disponibles dans un délai spécifié.
```
aws xray get-trace-summaries \
--start-time {{1568835392.0}} \
--end-time {{1568835446.0}}
```
Sortie :
```
[
"http://scorekeep-env-1.123456789.us-east-2.elasticbeanstalk.com/api/move/VSAE93HF/GSSD2NTB/DP0PCC09",
"http://scorekeep-env-1.123456789.us-east-2.elasticbeanstalk.com/api/move/GCQ2B35P/FREELDFT/4LRE643M",
"http://scorekeep-env-1.123456789.us-east-2.elasticbeanstalk.com/api/game/VSAE93HF/GSSD2NTB/starttime/1568835513",
"http://scorekeep-env-1.123456789.us-east-2.elasticbeanstalk.com/api/move/4MQNA5NN/L99KK2RF/null"
]
```
Pour plus d'informations, consultez la section [Utilisation de l' AWS X-Ray API avec la AWS CLI](https://docs.aws.amazon.com/xray/latest/devguide/xray-api-tutorial.html) dans le *manuel du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [GetTraceSummaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-trace-summaries.html)à la section *Référence des AWS CLI commandes*.
### `put-encryption-config`
L'exemple de code suivant montre comment utiliser`put-encryption-config`.
**AWS CLI**
**Pour mettre à jour la configuration de chiffrement**
L’exemple `put-encryption-config``example updates the encryption configuration for AWS X-Ray data to use the default AWS managed KMS key ``aws/xray` suivant.
```
aws xray put-encryption-config \
--type {{KMS}} \
--key-id {{alias/aws/xray}}
```
Sortie :
```
{
"EncryptionConfig": {
"KeyId": "arn:aws:kms:us-west-2:123456789012:key/c234g4e8-39e9-4gb0-84e2-b0ea215cbba5",
"Status": "UPDATING",
"Type": "KMS"
}
}
```
Pour plus d'informations, consultez [la section Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l' AWS X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [PutEncryptionConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/put-encryption-config.html)à la section *Référence des AWS CLI commandes*.
### `segments de put-trace`
L'exemple de code suivant montre comment utiliser`put-trace-segments`.
**AWS CLI**
**Pour charger un segment**
L'`put-trace-segments`exemple suivant télécharge des documents segmentés vers. AWS X-Ray Le document de segment est utilisé sous forme de liste de documents de segment JSON.
```
aws xray put-trace-segments \
--trace-segment-documents "{\"id\":\"20312a0e2b8809f4\",\"name\":\"DynamoDB\",\"trace_id\":\"1-5832862d-a43aafded3334a971fe312db\",\"start_time\":1.479706157195E9,\"end_time\":1.479706157202E9,\"parent_id\":\"79736b962fe3239e\",\"http\":{\"response\":{\"content_length\":60,\"status\":200}},\"inferred\":true,\"aws\":{\"consistent_read\":false,\"table_name\":\"scorekeep-session-xray\",\"operation\":\"GetItem\",\"request_id\":\"SCAU23OM6M8FO38UASGC7785ARVV4KQNSO5AEMVJF66Q9ASUAAJG\",\"resource_names\":[\"scorekeep-session-xray\"]},\"origin\":\"AWS::DynamoDB::Table\"}"
```
Sortie :
```
{
"UnprocessedTraceSegments": []
}
```
Pour plus d'informations, consultez la section [Envoi de données de trace à AWS X-Ray](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-sendingdata.html#xray-api-segments) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [PutTraceSegments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/put-trace-segments.html)à la section *Référence des AWS CLI commandes*.
### `groupe de mise à jour`
L'exemple de code suivant montre comment utiliser`update-group`.
**AWS CLI**
**Pour mettre à jour un groupe**
L’exemple `update-group` suivant met à jour les critères d’acceptation des suivis dans le groupe nommé `AdminGroup`. Vous pouvez spécifier le groupe souhaité en utilisant le nom ou l’ARN du groupe.
```
aws xray update-group \
--group-name {{"AdminGroup"}} \
--group-arn {{"arn:aws:xray:us-west-2:123456789012:group/AdminGroup/123456789"}} \
--filter-expression "service(\"mydomain.com\") {fault}"
```
Sortie :
```
{
"GroupName": "AdminGroup",
"GroupARN": "arn:aws:xray:us-east-2:123456789012:group/AdminGroup/123456789",
"FilterExpression": "service(\"mydomain.com\") {fault}"
}
```
Pour plus d'informations, consultez [la section Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l' AWS X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html#xray-api-configuration-sampling) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/update-group.html)à la section *Référence des AWS CLI commandes*.
### `règle d'échantillonnage de mise à jour`
L'exemple de code suivant montre comment utiliser`update-sampling-rule`.
**AWS CLI**
**Pour mettre à jour une règle d’échantillonnage**
L’exemple `update-sampling-rule` suivant modifie la configuration d’une règle d’échantillonnage. Les règles sont utilisées à partir d’un fichier JSON. Seuls les champs mis à jour sont obligatoires.
```
aws xray update-sampling-rule \
--cli-input-json {{file://1000-default.json}}
```
Contenu de `1000-default.json` :
```
{
"SamplingRuleUpdate": {
"RuleName": "Default",
"FixedRate": 0.01,
"ReservoirSize": 0
}
}
```
Sortie :
```
{
"SamplingRuleRecords": [
{
"SamplingRule": {
"RuleName": "Default",
"RuleARN": "arn:aws:xray:us-west-2:123456789012:sampling-rule/Default",
"ResourceARN": "*",
"Priority": 10000,
"FixedRate": 0.01,
"ReservoirSize": 0,
"ServiceName": "*",
"ServiceType": "*",
"Host": "*",
"HTTPMethod": "*",
"URLPath": "*",
"Version": 1,
"Attributes": {}
},
"CreatedAt": 0.0,
"ModifiedAt": 1529959993.0
}
]
}
```
Pour plus d'informations, consultez [la section Configuration des paramètres d'échantillonnage, de groupes et de chiffrement avec l' AWS X-Ray API](https://docs.aws.amazon.com/en_pv/xray/latest/devguide/xray-api-configuration.html#xray-api-configuration-sampling) dans le *guide du AWS X-Ray développeur*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateSamplingRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/update-sampling-rule.html)à la section *Référence des AWS CLI commandes*.