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-reportexemple 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 \ --timestamp1735059869\ --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-objectiveexemple 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.jsonContenu 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-objectiveexemple 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-objectiveexemple 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-serviceexemple suivant renvoie des informations sur un service découvert par Application Signals.aws application-signals get-service \ --start-time1732704000\ --end-time1732714500\ --key-attributesEnvironment=lambda:default,Name=hello-world-python,Type=ServiceSortie :
{ "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-dependenciesexemple suivant renvoie une liste des dépendances du service que vous spécifiez.aws application-signals list-service-dependencies \ --start-time1732021200\ --end-time1732107600\ --key-attributesEnvironment=api-gateway:prod,Name=PetAdoptionStatusUpdater,Type=ServiceSortie :
{ "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-dependentsexemple 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-time1732021200\ --end-time1732107600\ --key-attributesEnvironment=generic:default,Name=PetSite,Type=ServiceSortie :
{ "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-objectivesexemple suivant renvoie une liste des comptes SLOs créés dans ce compte.aws application-signals list-service-level-objectivesSortie :
{ "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-operationsexemple 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-time1735017423\ --end-time1735103823\ --key-attributesEnvironment=generic:default,Name=payforadoption,Type=ServiceSortie :
{ "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-servicesexemple suivant renvoie une liste des services découverts par Application Signals.aws application-signals list-services \ --start-time1734918791\ --end-time1734965591Sortie :
{ "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-resourceexemple 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-discoveryexemple 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-discoveryCette 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-resourceexemple 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-resourceexemple 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-objectiveexemple suivant met à jour un objectif de niveau de service (SLO) existant.aws application-signals update-service-level-objective \ --cli-input-jsonfile://update-slo.jsonContenu 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.
-