D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples
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.
Exemples de signaux d'application utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide des signaux d'application.
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 façon de configurer et d'exécuter le code en contexte.
Rubriques
Actions
L'exemple de code suivant montre comment utiliserbatch-get-service-level-objective-budget-report
.
- AWS CLI
-
Pour récupérer un ou plusieurs rapports budgétaires sur les objectifs de niveau de service (SLO).
L'
batch-get-service-level-objective-budget-report
exemple suivant extrait un ou plusieurs rapports budgétaires sur les objectifs de niveau de service (SLO).aws application-signals batch-get-service-level-objective-budget-report \ --timestamp
1735059869
\ --slo-ids"arn:aws:application-signals:us-east-1:123456789101:slo/SLOName1"
"arn:aws:application-signals:us-east-1:123456789101:slo/SLOName2"
Sortie :
{ "Timestamp": "2024-12-24T22:34:29+05:30", "Reports": [{ "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName1", "Name": "Your SLO Name", "EvaluationType": "PeriodBased", "BudgetStatus": "OK", "Attainment": 100.0, "TotalBudgetSeconds": 6048, "BudgetSecondsRemaining": 6048, "Sli": { "SliMetric": { "MetricDataQueries": [{ "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{ "Name": "InstanceId", "Value": "i-0e098765432522" }] }, "Period": 60, "Stat": "Average" }, "ReturnData": true }] }, "MetricThreshold": 200.0, "ComparisonOperator": "LessThanOrEqualTo" }, "Goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 7 } }, "AttainmentGoal": 99.0, "WarningThreshold": 50.0 } }, { "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName2", "Name": "test", "EvaluationType": "PeriodBased", "BudgetStatus": "BREACHED", "Attainment": 97.39583275, "TotalBudgetSeconds": 86, "BudgetSecondsRemaining": -2154, "Sli": { "SliMetric": { "MetricDataQueries": [{ "Id": "cwMetric", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{ "Name": "InstanceId", "Value": "i-0e12345678922" }] }, "Period": 300, "Stat": "Average" }, "ReturnData": true }] }, "MetricThreshold": 5.0, "ComparisonOperator": "GreaterThan" }, "Goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 1 } }, "AttainmentGoal": 99.9, "WarningThreshold": 30.0 } } ], "Errors": [] }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous BatchGetServiceLevelObjectiveBudgetReport
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-service-level-objective
.
- AWS CLI
-
Pour créer un objectif de niveau de service (SLO)
L'
create-service-level-objective
exemple suivant crée un objectif de niveau de service (SLO), qui peut vous aider à garantir que vos opérations commerciales critiques répondent aux attentes des clients.aws application-signals create-service-level-objective \ --name
"SLOName"
\ --description"Description of your SLO"
\ --sli-configfile://sli-config.json
Contenu de
sli-config.json
:{ "SliMetricConfig": { "MetricDataQueries": [ { "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0e5a1234561522" } ] }, "Period": 60, "Stat": "Average" }, "ReturnData": true } ] }, "MetricThreshold": 200, "ComparisonOperator": "LessThanOrEqualTo" }
Sortie :
{ "Slo": { "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName", "Name": "SLOName", "Description": "Description of your SLO", "CreatedTime": "2024-12-27T08:16:09.032000+05:30", "LastUpdatedTime": "2024-12-27T08:16:09.032000+05:30", "Sli": { "SliMetric": { "MetricDataQueries": [ { "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [ { "Name": "InstanceId", "Value": "i-0e59876543234522" } ] }, "Period": 60, "Stat": "Average" }, "ReturnData": true } ] }, "MetricThreshold": 200.0, "ComparisonOperator": "LessThanOrEqualTo" }, "EvaluationType": "PeriodBased", "Goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 7 } }, "AttainmentGoal": 99.0, "WarningThreshold": 50.0 } } }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous CreateServiceLevelObjective
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-service-level-objective
.
- AWS CLI
-
Pour supprimer l'objectif de niveau de service spécifié.
L'
delete-service-level-objective
exemple suivant supprime l'objectif de niveau de service spécifié.aws application-signals delete-service-level-objective \ --id
"arn:aws:application-signals:us-east-1:123456789101:slo/SLOName"
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous DeleteServiceLevelObjective
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-service-level-objective
.
- AWS CLI
-
Pour renvoyer des informations sur un SLO créé dans le compte
L'
get-service-level-objective
exemple suivant renvoie des informations sur un SLO créé dans le compte.aws application-signals get-service-level-objective \ --id
"arn:aws:application-signals:us-east-1:123456789101:slo/SLOName"
Sortie :
{ "Slo": { "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName", "Name": "SLOName", "Description": "Description of your SLO", "CreatedTime": "2024-12-24T22:19:18.624000+05:30", "LastUpdatedTime": "2024-12-24T22:19:55.280000+05:30", "Sli": { "SliMetric": { "MetricDataQueries": [{ "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{ "Name": "InstanceId", "Value": "i-0e0987654321522" }] }, "Period": 60, "Stat": "Average" }, "ReturnData": true }] }, "MetricThreshold": 200.0, "ComparisonOperator": "LessThanOrEqualTo" }, "EvaluationType": "PeriodBased", "Goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 7 } }, "AttainmentGoal": 99.0, "WarningThreshold": 50.0 } } }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous GetServiceLevelObjective
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-service
.
- AWS CLI
-
Pour renvoyer des informations sur un service découvert par Application Signals
L'
get-service
exemple suivant renvoie des informations sur un service découvert par Application Signals.aws application-signals get-service \ --start-time
1732704000
\ --end-time1732714500
\ --key-attributesEnvironment=lambda:default,Name=hello-world-python,Type=Service
Sortie :
{ "Service": { "KeyAttributes": { "Environment": "lambda:default", "Name": "hello-world-python", "Type": "Service" }, "AttributeMaps": [{ "Lambda.Function.Name": "hello-world-python", "PlatformType": "AWS::Lambda" }], "MetricReferences": [{ "Namespace": "ApplicationSignals", "MetricType": "LATENCY", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Latency" }, { "Namespace": "ApplicationSignals", "MetricType": "FAULT", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Fault" }, { "Namespace": "ApplicationSignals", "MetricType": "ERROR", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Error" }], "LogGroupReferences": [{ "Identifier": "/aws/lambda/hello-world-python", "ResourceType": "AWS::Logs::LogGroup", "Type": "AWS::Resource" }] }, "StartTime": "2024-11-27T10:00:00+00:00", "EndTime": "2024-11-27T14:00:01+00:00", "LogGroupReferences": [{ "Identifier": "/aws/lambda/hello-world-python", "ResourceType": "AWS::Logs::LogGroup", "Type": "AWS::Resource" }] }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous GetService
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-service-dependencies
.
- AWS CLI
-
Pour renvoyer une liste des dépendances du service que vous spécifiez
L'
list-service-dependencies
exemple suivant renvoie une liste des dépendances du service que vous spécifiez.aws application-signals list-service-dependencies \ --start-time
1732021200
\ --end-time1732107600
\ --key-attributesEnvironment=api-gateway:prod,
Name=PetAdoptionStatusUpdater,Type=Service
Sortie :
{ "ServiceDependencies": [{ "OperationName": "PUT /prod", "DependencyKeyAttributes": { "Environment": "lambda:default", "Name": "Services-name", "Type": "Service" }, "DependencyOperationName": "Invoke", "MetricReferences": [{ "Namespace": "ApplicationSignals", "MetricType": "LATENCY", "Dimensions": [{ "Name": "Environment", "Value": "api-gateway:prod" }, { "Name": "Operation", "Value": "PUT /prod" }, { "Name": "RemoteEnvironment", "Value": "lambda:default" }, { "Name": "RemoteOperation", "Value": "Invoke" }, { "Name": "RemoteService", "Value": "Services-name" }, { "Name": "Service", "Value": "PetAdoptionStatusUpdater" }], "MetricName": "Latency" }, { "Namespace": "ApplicationSignals", "MetricType": "FAULT", "Dimensions": [{ "Name": "Environment", "Value": "api-gateway:prod" }, { "Name": "Operation", "Value": "PUT /prod" }, { "Name": "RemoteEnvironment", "Value": "lambda:default" }, { "Name": "RemoteOperation", "Value": "Invoke" }, { "Name": "RemoteService", "Value": "Services-name" }, { "Name": "Service", "Value": "PetAdoptionStatusUpdater" }], "MetricName": "Fault" }, { "Namespace": "ApplicationSignals", "MetricType": "ERROR", "Dimensions": [{ "Name": "Environment", "Value": "api-gateway:prod" }, { "Name": "Operation", "Value": "PUT /prod" }, { "Name": "RemoteEnvironment", "Value": "lambda:default" }, { "Name": "RemoteOperation", "Value": "Invoke" }, { "Name": "RemoteService", "Value": "Services-name" }, { "Name": "Service", "Value": "PetAdoptionStatusUpdater" }], "MetricName": "Error" }] }], "StartTime": "2024-11-19T13:00:00+00:00", "EndTime": "2024-11-20T13:00:01+00:00" }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous ListServiceDependencies
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-service-dependents
.
- AWS CLI
-
Pour renvoyer la liste des personnes à charge qui ont invoqué le service spécifié pendant la période spécifiée
L'
list-service-dependents
exemple suivant renvoie la liste des personnes à charge qui ont invoqué le service spécifié pendant la période spécifiée.aws application-signals list-service-dependents \ --start-time
1732021200
\ --end-time1732107600
\ --key-attributesEnvironment=generic:default,Name=PetSite,Type=Service
Sortie :
{ "ServiceDependents": [{ "OperationName": "", "DependentKeyAttributes": { "Identifier": "pet-api-canary-hao", "ResourceType": "AWS::Synthetics::Canary", "Type": "AWS::Resource" }, "DependentOperationName": "", "MetricReferences": [] }, { "OperationName": "", "DependentKeyAttributes": { "Identifier": "PetSite", "ResourceType": "AWS::Synthetics::Canary", "Type": "AWS::Resource" }, "DependentOperationName": "", "MetricReferences": [] }], "StartTime": "2024-12-24T05:00:00+00:00", "EndTime": "2024-12-25T06:00:01+00:00" }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous ListServiceDependents
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-service-level-objectives
.
- AWS CLI
-
Pour renvoyer une liste des personnes SLOs créées dans ce compte.
L'
list-service-level-objectives
exemple suivant renvoie une liste des comptes SLOs créés dans ce compte.aws application-signals list-service-level-objectives
Sortie :
{ "SloSummaries": [{ "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/test", "Name": "test", "CreatedTime": "2024-12-24T22:01:21.116000+05:30" }] }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous ListServiceLevelObjectives
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-service-operations
.
- AWS CLI
-
Pour renvoyer une liste des opérations de ce service qui ont été découvertes par Application Signals
L'
list-service-operations
exemple suivant renvoie une liste des opérations de ce service qui ont été découvertes par Application Signals.aws application-signals list-service-operations \ --start-time
1735017423
\ --end-time1735103823
\ --key-attributesEnvironment=generic:default,Name=payforadoption,Type=Service
Sortie :
{ "ServiceOperations": [{ "Name": "POST /api", "MetricReferences": [{ "Namespace": "ApplicationSignals", "MetricType": "LATENCY", "Dimensions": [{ "Name": "Environment", "Value": "generic:default" }, { "Name": "Operation", "Value": "POST /api" }, { "Name": "Service", "Value": "payforadoption" }], "MetricName": "Latency" }, { "Namespace": "ApplicationSignals", "MetricType": "FAULT", "Dimensions": [{ "Name": "Environment", "Value": "generic:default" }, { "Name": "Operation", "Value": "POST /api" }, { "Name": "Service", "Value": "payforadoption" }], "MetricName": "Fault" }, { "Namespace": "ApplicationSignals", "MetricType": "ERROR", "Dimensions": [{ "Name": "Environment", "Value": "generic:default" }, { "Name": "Operation", "Value": "POST /api" }, { "Name": "Service", "Value": "payforadoption" }], "MetricName": "Error" }] }], "StartTime": "2024-12-24T05:00:00+00:00", "EndTime": "2024-12-25T06:00:01+00:00" }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous ListServiceOperations
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-services
.
- AWS CLI
-
Pour renvoyer une liste des services découverts par Application Signals
L'
list-services
exemple suivant renvoie une liste des services découverts par Application Signals.aws application-signals list-services \ --start-time
1734918791
\ --end-time1734965591
Sortie :
{ "ServiceSummaries": [{ "KeyAttributes": { "Environment": "lambda:default", "Name": "hello-world-python", "Type": "Service" }, "AttributeMaps": [{ "Lambda.Function.Name": "hello-world-python", "PlatformType": "AWS::Lambda" }], "MetricReferences": [{ "Namespace": "ApplicationSignals", "MetricType": "LATENCY", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Latency" }, { "Namespace": "ApplicationSignals", "MetricType": "FAULT", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Fault" }, { "Namespace": "ApplicationSignals", "MetricType": "ERROR", "Dimensions": [{ "Name": "Environment", "Value": "lambda:default" }, { "Name": "Service", "Value": "hello-world-python" }], "MetricName": "Error" }] }], "StartTime": "2024-11-27T10:00:00+00:00", "EndTime": "2024-11-27T14:00:01+00:00" }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous ListServices
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-tags-for-resource
.
- AWS CLI
-
Pour afficher les balises associées à une CloudWatch ressource
L'
list-tags-for-resource
exemple suivant affiche les balises associées à une CloudWatch ressource.aws application-signals list-tags-for-resource \ --resource-arn
"arn:aws:application-signals:us-east-1:123456789101:slo/SLOName"
Sortie :
{ "Tags": [{ "Key": "test", "Value": "value" }] }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous ListTagsForResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserstart-discovery
.
- AWS CLI
-
Pour permettre à ce compte Amazon Web Services d'utiliser les signaux CloudWatch d'application
L'
start-discovery
exemple suivant permet à ce compte Amazon Web Services d'utiliser les signaux d' CloudWatch application en créant le rôle AWS ServiceRoleForCloudWatchApplicationSignalslié au service.aws application-signals start-discovery
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous StartDiscovery
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisertag-resource
.
- AWS CLI
-
Pour attribuer une ou plusieurs balises (paires clé-valeur) à la CloudWatch ressource spécifiée, telle qu'un objectif de niveau de service
L'
tag-resource
exemple suivant attribue une ou plusieurs balises (paires clé-valeur) à la CloudWatch ressource spécifiée, par exemple un objectif de niveau de service.aws application-signals tag-resource \ --resource-arn
"arn:aws:application-signals:us-east-1:123456789101:slo/SLOName"
\ --tags '{"Key":"test","Value":"value"}
'Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous TagResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliseruntag-resource
.
- AWS CLI
-
Pour supprimer une ou plusieurs balises de la ressource spécifiée
L'
untag-resource
exemple suivant supprime une ou plusieurs balises de la ressource spécifiée.aws application-signals untag-resource \ --resource-arn
"arn:aws:application-signals:us-east-1:123456789101:slo/SLOName"
\ --tag-keys"test"
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous UntagResource
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-service-level-objective
.
- AWS CLI
-
Pour mettre à jour un objectif de niveau de service (SLO) existant
L'
update-service-level-objective
exemple suivant met à jour un objectif de niveau de service (SLO) existant.aws application-signals update-service-level-objective \ --cli-input-json
file://update-slo.json
Contenu de
update-slo.json
:{ "id": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName", "goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 7 } }, "AttainmentGoal": 90.0, "WarningThreshold": 50.0 } }
Sortie :
{ "Slo": { "Arn": "arn:aws:application-signals:us-east-1:123456789101:slo/SLOName", "Name": "SLOName", "Description": "Description of your SLO", "CreatedTime": "2024-12-24T22:19:18.624000+05:30", "LastUpdatedTime": "2024-12-27T08:51:38.278000+05:30", "Sli": { "SliMetric": { "MetricDataQueries": [{ "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{ "Name": "InstanceId", "Value": "i-00987654345222" }] }, "Period": 60, "Stat": "Average" }, "ReturnData": true }] }, "MetricThreshold": 200.0, "ComparisonOperator": "LessThanOrEqualTo" }, "EvaluationType": "PeriodBased", "Goal": { "Interval": { "RollingInterval": { "DurationUnit": "DAY", "Duration": 7 } }, "AttainmentGoal": 90.0, "WarningThreshold": 50.0 } } }
Pour plus d'informations, consultez Application Signals dans le guide de CloudWatch l'utilisateur Amazon.
-
Pour plus de détails sur l'API, reportez-vous UpdateServiceLevelObjective
à la section Référence des AWS CLI commandes.
-