• Le AWS Systems Manager CloudWatch tableau de bord ne sera plus disponible après le 30 avril 2026. Les clients peuvent continuer à utiliser CloudWatch la console Amazon pour consulter, créer et gérer leurs CloudWatch tableaux de bord Amazon, comme ils le font aujourd'hui. Pour plus d'informations, consultez la [documentation Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 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. # Créer OpsItems Une fois que vous avez configuré OpsCenter, un outil d’AWS Systems Manager, que vous l’avez intégré à vos Services AWS, vos Services AWS créent automatiquement des OpsItems en fonction de règles, d’événements ou d’alarmes par défaut. Vous pouvez consulter les statuts et les niveaux de sévérité des règles Amazon EventBridge par défaut. Si nécessaire, vous pouvez créer ou modifier ces règles depuis Amazon EventBridge. Vous pouvez également consulter les alarmes depuis Amazon CloudWatch et créer ou modifier des alarmes. À l'aide de règles et d'alarmes, vous pouvez configurer les événements pour lesquels vous souhaitez générer des OpsItems automatiquement. Lorsque le système crée un OpsItem, celui-ci est sous statut **Ouvert**. Vous pouvez modifier le statut pour **En cours** lorsque vous commencez à examiner l'OpsItem et pour **Résolu** une fois que vous avez corrigé l'OpsItem. Pour plus d'informations sur la façon de configurer les alarmes et les règles dans les Services AWS pour créer des OpsItems, ainsi que sur la façon de créer des Opsitems manuellement, consultez les rubriques suivantes. **Topics** + [Configurer EventBridge les règles pour créer OpsItems](OpsCenter-automatically-create-OpsItems-2.md) + [Configurer les CloudWatch alarmes pour créer OpsItems](OpsCenter-create-OpsItems-from-CloudWatch-Alarms.md) + [Créer manuellement OpsItems](OpsCenter-manually-create-OpsItems.md) # Configurer EventBridge les règles pour créer OpsItems Lorsqu'Amazon EventBridge reçoit un événement, il en crée un nouveau sur la OpsItem base des règles par défaut. Vous pouvez créer une règle ou modifier une règle existante pour la définir OpsCenter comme cible d'un EventBridge événement. Pour plus d'informations sur la création d'une règle d'événement, consultez la section [Création d'une règle pour un](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) événement Service AWS dans le *guide de EventBridge l'utilisateur Amazon*. **Pour configurer une EventBridge règle à créer OpsItems dans OpsCenter** 1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Dans le panneau de navigation, choisissez **Rules**. 1. Dans la page **Rules** (Règles), pour **Event Bus** (Bus d'événement), choisissez **défaut**. 1. Dans **Règles**, choisissez une règle en cochant la case à côté de son nom. 1. Sélectionnez le nom de la règle pour ouvrir sa page de détails. Dans la section **Détails de la règle**, vérifiez que **Statut** a la valeur **Activé**. **Note** Si nécessaire, vous pouvez mettre à jour le statut en utilisant **Modifier** dans l'angle supérieur droit de la page. 1. Choisissez l'onglet **Cibles**. 1. Dans l'onglet **Targets**, choisissez **Edit**. 1. Pour les **types de cibles**, sélectionnez **Service AWS**. 1. Pour **Target** (Cible), sélectionnez **Systems Manager OpsItem**. 1. Pour de nombreux types de cibles, EventBridge nécessite une autorisation pour envoyer des événements à la cible. Dans ces cas, EventBridge vous pouvez créer le rôle Gestion des identités et des accès AWS (IAM) nécessaire à l'exécution de votre règle : + Pour créer un rôle IAM automatiquement, sélectionnez **Create a new role for this specific resource**. + Pour utiliser un rôle IAM que vous avez créé pour EventBridge autoriser la création OpsItems dansOpsCenter, choisissez **Utiliser un rôle existant**. 1. Dans la section **Réglages supplémentaires**, pour **Configurer l'entrée cible**, choisissez **Transformateur d'entrée**. Vous pouvez utiliser l'option **Transformateur d'entrée** pour spécifier une chaîne de déduplication et d'autres informations importantes pour les OpsItems, telles qu'un titre et une sévérité. 1. Choisissez **Configure input transformer** (Configurer le transformateur d'entrée). 1. Dans la section **Transformateur d'entrée cible**, pour **Chemin d'entrée**, spécifiez les valeurs à analyser depuis l'événement déclencheur. Par exemple, pour analyser l'heure de début, l'heure de fin et d'autres détails de l'événement déclencheur de la règle, utilisez le code JSON suivant. ``` { "end-time": "$.detail.EndTime", "failure-cause": "$.detail.cause", "resources": "$.resources[0]", "source": "$.detail.source", "start-time": "$.detail.StartTime" } ``` 1. Pour **Template** (Modèle), spécifiez les informations à envoyer à la cible. Par exemple, utilisez le code JSON suivant pour transmettre des informations à OpsCenter. Les informations sont utilisées pour créer un OpsItem. **Note** Si le modèle d'entrée est au format JSON, la valeur de l'objet dans le modèle ne peut pas inclure de guillemets. Par exemple, les valeurs des ressources, de la cause de l'échec, de la source, de l'heure de début et de l'heure de fin ne peuvent pas être entre guillemets. ``` { "title": "EBS snapshot copy failed", "description": "CloudWatch Event Rule SSMOpsItems-EBS-snapshot-copy-failed was triggered. Your EBS snapshot copy has failed. See below for more details.", "category": "Availability", "severity": "2", "source": "EC2", "operationalData": { "/aws/dedup": { "type": "SearchableString", "value": "{\"dedupString\":\"SSMOpsItems-EBS-snapshot-copy-failed\"}" }, "/aws/automations": { "value": "[ { \"automationType\": \"AWS:SSM:Automation\", \"automationId\": \"AWS-CopySnapshot\" } ]" }, "failure-cause": { "value": }, "source": { "value": }, "start-time": { "value": }, "end-time": { "value": }, }, "resources": { "value": } } } ``` Pour plus d'informations sur ces champs, consultez la section [Transformation de la saisie cible](https://docs.aws.amazon.com/eventbridge/latest/userguide/transform-input.html) dans le *guide de EventBridge l'utilisateur Amazon*. 1. Choisissez **Confirmer**. 1. Choisissez **Suivant**. 1. Choisissez **Suivant**. 1. Choisissez **Mettre à jour la règle**. Une fois OpsItem créé à partir d'un événement, vous pouvez afficher les détails de l'événement en ouvrant OpsItem et en faisant défiler jusqu'à la section **Données opérationnelles privées**. Pour plus d'informations sur la configuration des options dans un OpsItem, consultez [Gestion des OpsItems](OpsCenter-working-with-OpsItems.md). # Configurer les CloudWatch alarmes pour créer OpsItems Lors de la configuration intégrée d'un outil OpsCenter AWS Systems Manager, vous permettez CloudWatch à Amazon de créer automatiquement en OpsItems fonction des alarmes courantes. Vous pouvez créer une alarme ou modifier une alarme existante pour créer des OpsItems dans OpsCenter. CloudWatch crée un nouveau rôle lié à un service dans Gestion des identités et des accès AWS (IAM) lorsque vous configurez une alarme à créer. OpsItems Le nouveau rôle est nommé `AWSServiceRoleForCloudWatchAlarms_ActionSSM`. *Pour plus d'informations sur les rôles CloudWatch liés à un service, consultez la section [Utilisation des rôles liés à un service dans CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-service-linked-roles.html) le guide de l'utilisateur Amazon. CloudWatch * Lorsqu'une CloudWatch alarme génère unOpsItem, l'**CloudWatch alarme OpsItem s'affiche : « *alarm\$1name* » est en état ALARM**. Pour afficher des détails sur un OpsItem particulier, sélectionnez l'OpsItem, puis sélectionnez l'onglet **Détails des ressources connexes**. Vous pouvez modifier manuellement des OpsItems pour modifier des détails tels que la sévérité ou la catégorie. Toutefois, lorsque vous modifiez la sévérité ou la catégorie d'une alarme, Systems Manager ne peut pas mettre à jour la sévérité ou la catégorie d'OpsItems déjà créés à partir de l'alarme. Si une alarme a créé une chaîne de déduplication OpsItem et si vous avez spécifié une chaîne de déduplication, l'alarme n'en créera pas d'autre, OpsItems même si vous la modifiez. CloudWatch Si le problème OpsItem est résolu dansOpsCenter, CloudWatch il en créera un nouveauOpsItem. Pour plus d'informations sur la configuration des CloudWatch alarmes, consultez les rubriques suivantes. **Topics** + [Configuration d'une CloudWatch alarme à créer OpsItems (console)](OpsCenter-creating-or-editing-existing-alarm-console.md) + [Configuration d'une CloudWatch alarme existante à créer OpsItems (par programmation)](OpsCenter-configuring-an-existing-alarm-programmatically.md) # Configuration d'une CloudWatch alarme à créer OpsItems (console) Vous pouvez créer manuellement une alarme ou mettre à jour une alarme existante pour la créer OpsItems depuis Amazon CloudWatch. **Pour créer une CloudWatch alarme et configurer Systems Manager comme cible de cette alarme** 1. Effectuez les étapes 1 à 9 comme indiqué dans la [section Création CloudWatch d'une alarme basée sur un seuil statique](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) dans le *guide de l' CloudWatch utilisateur Amazon*. 1. Dans la section **Action Systems Manager**, choisissez l'** OpsCenter action Add Systems Manager**. 1. Sélectionnez **OpsItems**. 1. Pour **Sévérité**, sélectionnez une valeur de 1 à 4. 1. (Facultatif) Pour **Catégorie**, sélectionnez une catégorie pour l'OpsItem. 1. Effectuez les étapes 11 à 13 comme indiqué dans la section [Création d'une CloudWatch alarme basée sur un seuil statique](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) dans le guide de * CloudWatch l'utilisateur Amazon*. 1. Sélectionnez **Next (Suivant)** et suivez l'assistant. **Procédez comme suit pour modifier une alarme existante et configurer Systems Manager comme la cible de cette alarme.** 1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Dans le panneau de navigation, cliquez sur **Alarms (alertes)**. 1. Sélectionnez l'alarme, puis **Actions**, **Edit (Modifier)**. 1. (Facultatif) Modifiez les paramètres dans les sections **Metrics (Métriques)** et **Conditions**, puis sélectionnez **Next (Suivant)**. 1. Dans la section **Systems Manager**, sélectionnez **Add Systems Manager OpsCenter action (Ajouter une action Systems Manager OpsCenter)**. 1. Pour **Severity (Sévérité)**, sélectionnez un nombre. **Note** La sévérité est une valeur définie par l'utilisateur. Vous ou votre organisation déterminez la signification de chaque valeur de sévérité et les accords de niveau de service associés à chaque sévérité. 1. (Facultatif) Pour **Category (Catégorie)**, sélectionnez une option. 1. Sélectionnez **Next (Suivant)** et suivez l'assistant. # Configuration d'une CloudWatch alarme existante à créer OpsItems (par programmation) Vous pouvez configurer les CloudWatch alarmes Amazon pour qu'elles OpsItems soient créées par programmation à l'aide de AWS Command Line Interface (AWS CLI), de AWS CloudFormation modèles ou d'extraits de Java code. **Topics** + [Avant de commencer](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin) + [Configuration des CloudWatch alarmes pour créer OpsItems (AWS CLI)](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-manually-configure-cli) + [Configuration des CloudWatch alarmes à créer ou à mettre à jour OpsItems (CloudFormation)](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-CloudFormation) + [Configuration des CloudWatch alarmes à créer ou à mettre à jour OpsItems (Java)](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-java) ## Avant de commencer Si vous modifiez une alarme existante par programmation ou que vous créez une nouvelle alarme créant des OpsItems, vous devez spécifier un Amazon Resource Name (ARN). Cet ARN identifie Systems Manager OpsCenter comme la cible des OpsItems créés à partir de l'alarme. Vous pouvez personnaliser l'ARN de sorte que des OpsItems créés à partir de l'alarme incluent des informations spécifiques telles que la sévérité ou la catégorie. Chaque ARN inclut les informations décrites dans le tableau suivant. **** | Paramètre | Détails | | --- | --- | | `Region` (obligatoire) | L' Région AWS endroit où se trouve l'alarme. Par exemple : `us-west-2`. Pour obtenir des informations sur les Régions AWS dans lesquelles utiliser OpsCenter, consultez [AWS Systems Manager Points de terminaison et quotas](https://docs.aws.amazon.com/general/latest/gr/ssm.html). | | `account_ID` (obligatoire) | Le même Compte AWS identifiant que celui utilisé pour créer l'alarme. Par exemple : `123456789012`. L'ID de compte doit être suivi du signe deux-points (`:`) et du paramètre `opsitem`, comme le montrent les exemples suivants. | | `severity` (obligatoire) | Un niveau de sévérité défini par l'utilisateur pour les OpsItems créés à partir de l'alarme. Valeurs valides : `1`, `2`, `3`, `4` | | `Category` (facultatif) | Une catégorie pour des OpsItems créés à partir de l'alarme. Valeurs valides : `Availability`, `Cost`, `Performance`, `Recovery` et `Security`. | Créez l'ARN en utilisant la syntaxe suivante. Cet ARN n'inclut pas le paramètre `Category` facultatif. ``` arn:aws:ssm:Region:account_ID:opsitem:severity ``` Voici un exemple. ``` arn:aws:ssm:us-west-2:123456789012:opsitem:3 ``` Pour créer un ARN utilisant le paramètre `Category` facultatif, respectez la syntaxe suivante. ``` arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name ``` Voici un exemple. ``` arn:aws:ssm:us-west-2:123456789012:opsitem:3#CATEGORY=Security ``` ## Configuration des CloudWatch alarmes pour créer OpsItems (AWS CLI) Cette commande exige que vous spécifiiez un ARN pour le paramètre `alarm-actions`. Pour de plus amples informations sur la création de l'ARN, consultez [Avant de commencer](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin). **Pour configurer une CloudWatch alarme à créer OpsItems (AWS CLI)** 1. Installez et configurez le AWS Command Line Interface (AWS CLI), si ce n'est pas déjà fait. Pour de plus amples informations, consultez [Installation ou mise à jour de la version la plus récente de l' AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). 1. Exécutez la commande suivante pour collecter des informations sur l'alarme à configurer. ``` aws cloudwatch describe-alarms --alarm-names "alarm name" ``` 1. Exécutez la commande suivante pour mettre à jour une alarme. Remplacez chaque *example resource placeholder* par vos propres informations. ``` aws cloudwatch put-metric-alarm --alarm-name name \ --alarm-description "description" \ --metric-name name --namespace namespace \ --statistic statistic --period value --threshold value \ --comparison-operator value \ --dimensions "dimensions" --evaluation-periods value \ --alarm-actions arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name \ --unit unit ``` Voici un exemple : ------ #### [ Linux & macOS ] ``` aws cloudwatch put-metric-alarm --alarm-name cpu-mon \ --alarm-description "Alarm when CPU exceeds 70 percent" \ --metric-name CPUUtilization --namespace AWS/EC2 \ --statistic Average --period 300 --threshold 70 \ --comparison-operator GreaterThanThreshold \ --dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 \ --alarm-actions arn:aws:ssm:us-east-1:123456789012:opsitem:3#CATEGORY=Security \ --unit Percent ``` ------ #### [ Windows ] ``` aws cloudwatch put-metric-alarm --alarm-name cpu-mon ^ --alarm-description "Alarm when CPU exceeds 70 percent" ^ --metric-name CPUUtilization --namespace AWS/EC2 ^ --statistic Average --period 300 --threshold 70 ^ --comparison-operator GreaterThanThreshold ^ --dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 ^ --alarm-actions arn:aws:ssm:us-east-1:123456789012:opsitem:3#CATEGORY=Security ^ --unit Percent ``` ------ ## Configuration des CloudWatch alarmes à créer ou à mettre à jour OpsItems (CloudFormation) Cette section inclut des AWS CloudFormation modèles que vous pouvez utiliser pour configurer des CloudWatch alarmes afin de les créer ou de les mettre à jour automatiquementOpsItems. Chaque modèle de code exige que vous spécifiiez un Amazon Resource Name (ARN) pour le paramètre `AlarmActions`. Pour de plus amples informations sur la création de l'ARN, consultez [Avant de commencer](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin). **Alarme métrique** — Utilisez le CloudFormation modèle suivant pour créer ou mettre à jour une alarme CloudWatch métrique. L'alarme spécifiée dans ce modèle contrôle les vérifications du statut d'instances Amazon Elastic Compute Cloud (Amazon EC2). Si l'alarme entre dans l'état `ALARM`, un OpsItem est créé dans OpsCenter. ``` { "AWSTemplateFormatVersion": "2010-09-09", "Parameters" : { "RecoveryInstance" : { "Description" : "The EC2 instance ID to associate this alarm with.", "Type" : "AWS::EC2::Instance::Id" } }, "Resources": { "RecoveryTestAlarm": { "Type": "AWS::CloudWatch::Alarm", "Properties": { "AlarmDescription": "Run a recovery action when instance status check fails for 15 consecutive minutes.", "Namespace": "AWS/EC2" , "MetricName": "StatusCheckFailed_System", "Statistic": "Minimum", "Period": "60", "EvaluationPeriods": "15", "ComparisonOperator": "GreaterThanThreshold", "Threshold": "0", "AlarmActions": [ {"Fn::Join" : ["", ["arn:arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name", { "Ref" : "AWS::Partition" }, ":ssm:", { "Ref" : "AWS::Region" }, { "Ref" : "AWS:: AccountId" }, ":opsitem:3" ]]} ], "Dimensions": [{"Name": "InstanceId","Value": {"Ref": "RecoveryInstance"}}] } } } } ``` **Alarme composite** : utilisez le CloudFormation modèle suivant pour créer ou mettre à jour une alarme composite. Une alarme composite est constituée de plusieurs alarmes de métrique. Si l'alarme entre dans l'état `ALARM`, un OpsItem est créé dans OpsCenter. ``` "Resources":{ "HighResourceUsage":{ "Type":"AWS::CloudWatch::CompositeAlarm", "Properties":{ "AlarmName":"HighResourceUsage", "AlarmRule":"(ALARM(HighCPUUsage) OR ALARM(HighMemoryUsage)) AND NOT ALARM(DeploymentInProgress)", "AlarmActions":"arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name", "AlarmDescription":"Indicates that the system resource usage is high while no known deployment is in progress" }, "DependsOn":[ "DeploymentInProgress", "HighCPUUsage", "HighMemoryUsage" ] }, "DeploymentInProgress":{ "Type":"AWS::CloudWatch::CompositeAlarm", "Properties":{ "AlarmName":"DeploymentInProgress", "AlarmRule":"FALSE", "AlarmDescription":"Manually updated to TRUE/FALSE to disable other alarms" } }, "HighCPUUsage":{ "Type":"AWS::CloudWatch::Alarm", "Properties":{ "AlarmDescription":"CPUusageishigh", "AlarmName":"HighCPUUsage", "ComparisonOperator":"GreaterThanThreshold", "EvaluationPeriods":1, "MetricName":"CPUUsage", "Namespace":"CustomNamespace", "Period":60, "Statistic":"Average", "Threshold":70, "TreatMissingData":"notBreaching" } }, "HighMemoryUsage":{ "Type":"AWS::CloudWatch::Alarm", "Properties":{ "AlarmDescription":"Memoryusageishigh", "AlarmName":"HighMemoryUsage", "ComparisonOperator":"GreaterThanThreshold", "EvaluationPeriods":1, "MetricName":"MemoryUsage", "Namespace":"CustomNamespace", "Period":60, "Statistic":"Average", "Threshold":65, "TreatMissingData":"breaching" } } } ``` ## Configuration des CloudWatch alarmes à créer ou à mettre à jour OpsItems (Java) Cette section inclut des extraits de Java code que vous pouvez utiliser pour configurer des CloudWatch alarmes afin qu'elles soient créées ou mises à jour automatiquement. OpsItems Chaque extrait exige que vous spécifiiez un ARN pour le paramètre `validSsmActionStr`. Pour de plus amples informations sur la création de l'ARN, consultez [Avant de commencer](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin). **Une alarme spécifique** — Utilisez l'extrait de Java code suivant pour créer ou mettre à jour une CloudWatch alarme. L'alarme spécifiée dans ce modèle contrôle les vérifications du statut d'instances Amazon EC2. Si l'alarme entre dans l'état `ALARM`, un OpsItem est créé dans OpsCenter. ``` import com.amazonaws.services.cloudwatch.AmazonCloudWatch; import com.amazonaws.services.cloudwatch.AmazonCloudWatchClientBuilder; import com.amazonaws.services.cloudwatch.model.ComparisonOperator; import com.amazonaws.services.cloudwatch.model.Dimension; import com.amazonaws.services.cloudwatch.model.PutMetricAlarmRequest; import com.amazonaws.services.cloudwatch.model.PutMetricAlarmResult; import com.amazonaws.services.cloudwatch.model.StandardUnit; import com.amazonaws.services.cloudwatch.model.Statistic; private void putMetricAlarmWithSsmAction() { final AmazonCloudWatch cw = AmazonCloudWatchClientBuilder.defaultClient(); Dimension dimension = new Dimension() .withName("InstanceId") .withValue(instanceId); String validSsmActionStr = "arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name"; PutMetricAlarmRequest request = new PutMetricAlarmRequest() .withAlarmName(alarmName) .withComparisonOperator( ComparisonOperator.GreaterThanThreshold) .withEvaluationPeriods(1) .withMetricName("CPUUtilization") .withNamespace("AWS/EC2") .withPeriod(60) .withStatistic(Statistic.Average) .withThreshold(70.0) .withActionsEnabled(false) .withAlarmDescription( "Alarm when server CPU utilization exceeds 70%") .withUnit(StandardUnit.Seconds) .withDimensions(dimension) .withAlarmActions(validSsmActionStr); PutMetricAlarmResult response = cw.putMetricAlarm(request); } ``` **Mettre à jour toutes les alarmes** : utilisez l'extrait de Java code suivant pour mettre à jour toutes les CloudWatch alarmes de votre système Compte AWS afin de les créer OpsItems lorsqu'une alarme entre dans l'`ALARM`état. ``` import com.amazonaws.services.cloudwatch.AmazonCloudWatch; import com.amazonaws.services.cloudwatch.AmazonCloudWatchClientBuilder; import com.amazonaws.services.cloudwatch.model.DescribeAlarmsRequest; import com.amazonaws.services.cloudwatch.model.DescribeAlarmsResult; import com.amazonaws.services.cloudwatch.model.MetricAlarm; private void listMetricAlarmsAndAddSsmAction() { final AmazonCloudWatch cw = AmazonCloudWatchClientBuilder.defaultClient(); boolean done = false; DescribeAlarmsRequest request = new DescribeAlarmsRequest(); String validSsmActionStr = "arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name"; while(!done) { DescribeAlarmsResult response = cw.describeAlarms(request); for(MetricAlarm alarm : response.getMetricAlarms()) { // assuming there are no alarm actions added for the metric alarm alarm.setAlarmActions(ImmutableList.of(validSsmActionStr)); } request.setNextToken(response.getNextToken()); if(response.getNextToken() == null) { done = true; } } } ``` # Créer manuellement OpsItems Lorsque vous détectez un problème opérationnel, vous pouvez créer manuellement un OpsItem depuis OpsCenter (un outil d’AWS Systems Manager) afin de gérer et de résoudre le problème. Si vous configurez OpsCenter pour une administration multicomptes, un compte administrateur délégué Systems Manager ou un compte de gestion AWS Organizations peut créer des OpsItems pour les comptes membre. Pour de plus amples informations, consultez [(Facultatif) Configurez manuellement OpsCenter pour gérer de manière centralisée OpsItems sur l’ensemble des comptes](OpsCenter-getting-started-multiple-accounts.md). Vous pouvez créer des OpsItems à l'aide de la console AWS Systems Manager, de l'AWS Command Line Interface (AWS CLI) ou d'AWS Tools for Windows PowerShell. **Topics** + [Création manuelle d'OpsItems (console)](OpsCenter-creating-OpsItems-console.md) + [Création manuelle d'OpsItems (AWS CLI)](OpsCenter-creating-OpsItems-CLI.md) + [Création manuelle d'OpsItems (PowerShell)](OpsCenter-creating-OpsItems-Powershell.md) # Création manuelle d'OpsItems (console) Vous pouvez créer manuellement à OpsItems l'aide de la AWS Systems Manager console. Lorsque vous créez un OpsItem, il s'affiche dans votre compte OpsCenter. Si vous configurez OpsCenter pour l'administration multicomptes, OpsCenter fournit à l'administrateur délégué ou au compte de gestion la possibilité de créer des OpsItems pour les comptes membre sélectionnés. Pour de plus amples informations, veuillez consulter [(Facultatif) Configurez manuellement OpsCenter pour gérer de manière centralisée OpsItems sur l’ensemble des comptes](OpsCenter-getting-started-multiple-accounts.md). **Pour créer un à OpsItem l'aide de la AWS Systems Manager console** 1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. Dans le panneau de navigation, sélectionnez **OpsCenter**. 1. Sélectionnez **Créer un OpsItem**. Si vous ne voyez pas ce bouton, cliquez sur l'onglet **OpsItems**, puis sélectionnez **Create OpsItem (Créer un OpsItem)**. 1. (Facultatif) Choisissez **Autre compte**, puis choisissez le compte pour lequel vous souhaitez créer l'OpsItem. **Note** Cette étape est obligatoire si vous créez des OpsItems pour un compte membre. 1. Dans **Titre**, saisissez un nom descriptif pour vous aider à comprendre l'objectif de l'OpsItem. 1. Pour **Source**, saisissez le type de ressource AWS impacté ou d'autres informations source pour aider les utilisateurs à comprendre l'origine de l'OpsItem. **Note** Vous ne pouvez pas modifier le champ **Source** après avoir créé OpsItem. 1. (Facultatif) Pour **Priority (Priorité)**, sélectionnez le niveau de priorité. 1. (Facultatif) Pour **Severity (Sévérité)**, sélectionnez le niveau de sévérité. 1. (Facultatif) Pour **Category (Catégorie)**, sélectionnez une catégorie. 1. Pour **Description**, saisissez des informations à propos de cet OpsItem y compris (le cas échéant) les étapes de reproduction du problème. **Note** La console prend en charge la plupart des mises en forme du Markdown dans le champ de OpsItem description. Pour plus d'informations, consultez [Utilisation de Markdown dans la console](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html) du *Guide de mise en route de la AWS Management Console *. 1. Pour **Chaîne de déduplication**, saisissez les mots que le système peut utiliser pour rechercher les OpsItems en double. Pour plus d'informations sur les chaînes de déduplication, consultez [Gestion des OpsItems en double](OpsCenter-working-deduplication.md). 1. (Facultatif) Pour **Notifications**, spécifiez l'Amazon Resource Name (ARN) de la rubrique Amazon SNS dans laquelle vous souhaitez envoyer des notifications lorsque cet OpsItem est mis à jour. Vous devez spécifier un ARN Amazon SNS Région AWS identique au. OpsItem 1. (Facultatif) Sous **Ressources connexes**, choisissez **Ajouter** pour spécifier l'ID ou l'ARN de la ressource affectée et de toute ressource connexe. 1. Choisissez **CréerOpsItem**. En cas de succès, la page affiche l'OpsItem. Lorsqu'un compte d'administrateur ou de gestion délégué crée un OpsItem pour des comptes membre sélectionnés, les nouveaux OpsItems sont affichés dans l'OpsCenter de l'administrateur et des membres. Pour plus d'informations sur la configuration des options dans un OpsItem, consultez [Gestion des OpsItems](OpsCenter-working-with-OpsItems.md). # Création manuelle d'OpsItems (AWS CLI) La procédure suivante décrit comment créer un clone OpsItem à l'aide de l' AWS Command Line Interface (AWS CLI). **Pour créer un à OpsItem l'aide du AWS CLI** 1. Installez et configurez le AWS Command Line Interface (AWS CLI), si ce n'est pas déjà fait. Pour de plus amples informations, consultez [Installation ou mise à jour de la version la plus récente de l' AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). 1. Ouvrez le AWS CLI et exécutez la commande suivante pour créer unOpsItem. Remplacez chaque *example resource placeholder* par vos propres informations. ``` aws ssm create-ops-item \ --title "Descriptive_title" \ --description "Information_about_the_issue" \ --priority Number_between_1_and_5 \ --source Source_of_the_issue \ --operational-data Up_to_20_KB_of_data_or_path_to_JSON_file \ --notifications Arn="SNS_ARN_in_same_Region" \ --tags "Key=key_name,Value=a_value" ``` **Spécifier les données opérationnelles à partir d'un fichier** Lorsque vous créez un OpsItem, vous pouvez spécifier des données opérationnelles à partir d'un fichier. Le fichier doit être un fichier JSON et le contenu du fichier doit utiliser le format suivant. ``` { "key_name": { "Type": "SearchableString", "Value": "Up to 20 KB of data" } } ``` Voici un exemple. ``` aws ssm create-ops-item ^ --title "EC2 instance disk full" ^ --description "Log clean up may have failed which caused the disk to be full" ^ --priority 2 ^ --source ec2 ^ --operational-data file:///Users/TestUser1/Desktop/OpsItems/opsData.json ^ --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" ^ --tags "Key=EC2,Value=Production" ``` **Note** Pour plus d'informations sur la saisie de paramètres au format JSON sur la ligne de commande sous différents systèmes d'exploitation locaux, consultez [Utilisation de guillemets avec des chaînes dans la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) dans le *Guide de l'utilisateur AWS Command Line Interface *. Le système retourne des informations telles que les suivantes. ``` { "OpsItemId": "oi-1a2b3c4d5e6f" } ``` 1. Maintenant, exécutez la commande suivante pour afficher les détails relatifs à l'OpsItem que vous avez créé. ``` aws ssm get-ops-item --ops-item-id ID ``` Le système retourne des informations telles que les suivantes. ``` { "OpsItem": { "CreatedBy": "arn:aws:iam::12345678:user/TestUser", "CreatedTime": 1558386334.995, "Description": "Log clean up may have failed which caused the disk to be full", "LastModifiedBy": "arn:aws:iam::12345678:user/TestUser", "LastModifiedTime": 1558386334.995, "Notifications": [ { "Arn": "arn:aws:sns:us-west-1:12345678:TestUser" } ], "Priority": 2, "RelatedOpsItems": [], "Status": "Open", "OpsItemId": "oi-1a2b3c4d5e6f", "Title": "EC2 instance disk full", "Source": "ec2", "OperationalData": { "EC2": { "Value": "12345", "Type": "SearchableString" } } } } ``` 1. Exécutez la commande suivante pour mettre à jour une tâche OpsItem. Cette commande modifie le statut de `Open` (la valeur par défaut) et le remplace par `InProgress`. ``` aws ssm update-ops-item --ops-item-id ID --status InProgress ``` La commande n'a aucune sortie. 1. Exécutez à nouveau la commande suivante pour vérifier que le statut est passé à `InProgress`. ``` aws ssm get-ops-item --ops-item-id ID ``` ## Exemples de création d'un OpsItem Les exemples de code suivants vous montrent comment créer un OpsItem à l'aide du portail de gestion Linux, macOS ou Windows Server. **Portail de gestion Linux ou macOS** La commande suivante crée un OpsItem quand un disque d'instance Amazon Elastic Compute Cloud (Amazon EC2) est plein. ``` aws ssm create-ops-item \ --title "EC2 instance disk full" \ --description "Log clean up may have failed which caused the disk to be full" \ --priority 2 \ --source ec2 \ --operational-data '{"EC2":{"Value":"12345","Type":"SearchableString"}}' \ --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" \ --tags "Key=EC2,Value=ProductionServers" ``` La commande suivante utilise la clé `/aws/resources` dans `OperationalData` pour créer un OpsItem avec une ressource Amazon DynamoDB connexe. ``` aws ssm create-ops-item \ --title "EC2 instance disk full" \ --description "Log clean up may have failed which caused the disk to be full" \ --priority 2 \ --source ec2 \ --operational-data '{"/aws/resources":{"Value":"[{\"arn\": \"arn:aws:dynamodb:us-west-2:12345678:table/OpsItems\"}]","Type":"SearchableString"}}' \ --notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser" ``` La commande suivante utilise la clé `/aws/automations` dans `OperationalData` pour créer un OpsItem qui spécifie le document `AWS-ASGEnterStandby` en tant que runbook Automation associé. ``` aws ssm create-ops-item \ --title "EC2 instance disk full" \ --description "Log clean up may have failed which caused the disk to be full" \ --priority 2 \ --source ec2 \ --operational-data '{"/aws/automations":{"Value":"[{\"automationId\": \"AWS-ASGEnterStandby\", \"automationType\": \"AWS::SSM::Automation\"}]","Type":"SearchableString"}}' \ --notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser" ``` **Windows** La commande suivante crée un OpsItem lorsqu'une instance Amazon Relational Database Service (Amazon RDS) ne répond pas. ``` aws ssm create-ops-item ^ --title "RDS instance not responding" ^ --description "RDS instance not responding to ping" ^ --priority 1 ^ --source RDS ^ --operational-data={\"RDS\":{\"Value\":\"abcd\",\"Type\":\"SearchableString\"}} ^ --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" ^ --tags "Key=RDS,Value=ProductionServers" ``` La commande suivante utilise la clé `/aws/resources` dans `OperationalData` pour créer un OpsItem avec une ressource connexe de l'instance EC2. ``` aws ssm create-ops-item ^ --title "EC2 instance disk full" ^ --description "Log clean up may have failed which caused the disk to be full" ^ --priority 2 ^ --source ec2 ^ --operational-data={\"/aws/resources\":{\"Value\":\"[{\\"""arn\\""":\\"""arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0\\"""}]\",\"Type\":\"SearchableString\"}} ``` La commande suivante utilise la clé `/aws/automations` dans `OperationalData` pour créer un OpsItem qui spécifie le runbook `AWS-RestartEC2Instance` en tant que runbook Automation associé. ``` aws ssm create-ops-item ^ --title "EC2 instance disk full" ^ --description "Log clean up may have failed which caused the disk to be full" ^ --priority 2 ^ --source ec2 ^ --operational-data={\"/aws/automations\":{\"Value\":\"[{\\"""automationId\\""":\\"""AWS-RestartEC2Instance\\”"",\\"""automationType\\""":\\"""AWS::SSM::Automation\\"""}]\",\"Type\":\"SearchableString\"}} ``` # Création manuelle d'OpsItems (PowerShell) La procédure suivante décrit comment créer un OpsItem à l'aide de AWS Tools for Windows PowerShell. **Pour créer une OpsItem utilisation AWS Tools for Windows PowerShell** 1. Ouvrez AWS Tools for Windows PowerShell et exécutez la commande suivante pour spécifier vos informations d'identification. ``` Set-AWSCredentials –AccessKey key-name –SecretKey key-name ``` 1. Exécutez la commande suivante pour définir le Région AWS pour votre PowerShell session. ``` Set-DefaultAWSRegion -Region Region ``` 1. Exécutez la commande suivante pour créer un nouveau OpsItem. Remplacez chaque *example resource placeholder* par vos propres informations. Cette commande spécifie un runbook Systems Manager Automation pour corriger cet OpsItem. ``` $opsItem = New-Object Amazon.SimpleSystemsManagement.Model.OpsItemDataValue $opsItem.Type = [Amazon.SimpleSystemsManagement.OpsItemDataType]::SearchableString $opsItem.Value = '[{\"automationId\":\"runbook_name\",\"automationType\":\"AWS::SSM::Automation\"}]' $newHash = @{" /aws/automations"=[Amazon.SimpleSystemsManagement.Model.OpsItemDataValue]$opsItem} New-SSMOpsItem ` -Title "title" ` -Description "description" ` -Priority priority_number ` -Source AWS_service ` -OperationalData $newHash ``` En cas de réussite, la commande génère l'ID du nouveau OpsItem. L'exemple suivant spécifie l'Amazon Resource Name (ARN) d'une instance Amazon Elastic Compute Cloud (Amazon EC2). ``` $opsItem = New-Object Amazon.SimpleSystemsManagement.Model.OpsItemDataValue $opsItem.Type = [Amazon.SimpleSystemsManagement.OpsItemDataType]::SearchableString $opsItem.Value = '[{\"arn\":\"arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0\"}]' $newHash = @{" /aws/resources"=[Amazon.SimpleSystemsManagement.Model.OpsItemDataValue]$opsItem} New-SSMOpsItem -Title "EC2 instance disk full still" -Description "Log clean up may have failed which caused the disk to be full" -Priority 2 -Source ec2 -OperationalData $newHash ```