• El panel de AWS Systems Manager CloudWatch dejará de estar disponible después del 30 de abril de 2026. Los clientes pueden seguir utilizando la consola de Amazon CloudWatch para ver, crear y administrar sus paneles de Amazon CloudWatch, tal y como lo hacen actualmente. Para obtener más información, consulte la [documentación del panel de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
# Configuración de alarmas de CloudWatch para crear OpsItems
Durante la instalación integrada de OpsCenter, una herramienta de AWS Systems Manager, permite que Amazon CloudWatch cree OpsItems automáticamente en función de alarmas comunes. Puede crear una alarma o editar una alarma existente para crear OpsItems en OpsCenter.
CloudWatch crea un nuevo rol vinculado a un servicio en AWS Identity and Access Management (IAM) cuando configura una alarma para crear OpsItems. El rol nuevo se denomina `AWSServiceRoleForCloudWatchAlarms_ActionSSM`. Para obtener más información acerca de los roles vinculados a servicios de CloudWatch, consulte [Uso de roles vinculados a servicios de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-service-linked-roles.html) en la *Guía del usuario de Amazon CloudWatch*.
Cuando una alarma de CloudWatch genera un OpsItem, el OpsItem muestra **Alarma de CloudWatch: “*alarm\$1name*” está en estado ALARM**.
Para ver los detalles de un OpsItem determinado, elija el OpsItem y, a continuación, elija la pestaña **Detalles de recursos relacionados**. Puede editar OpsItems de forma manual para cambiar detalles como la gravedad o la categoría. Sin embargo, al editar la gravedad o la categoría de una alarma, Systems Manager no puede actualizar la gravedad o la categoría de los OpsItems que ya se han creado a partir de la alarma. Si una alarma crea un OpsItem y si especificó una cadena de desduplicación, la alarma no creará OpsItems adicionales incluso si edita la alarma en CloudWatch. Si el OpsItem se resuelve en OpsCenter, CloudWatch creará un nuevo OpsItem.
Para obtener más información sobre la configuración de alarmas de CloudWatch, consulte los siguientes temas.
**Topics**
+ [
# Configuración de una alarma de CloudWatch para crear OpsItems (consola)
](OpsCenter-creating-or-editing-existing-alarm-console.md)
+ [
# Configuración de una alarma de CloudWatch existente para crear OpsItems (mediante programación)
](OpsCenter-configuring-an-existing-alarm-programmatically.md)
# Configuración de una alarma de CloudWatch para crear OpsItems (consola)
Puede crear manualmente una alarma o actualizar una alarma existente para crear OpsItems desde Amazon CloudWatch.
**Para crear una alarma de CloudWatch y configurar Systems Manager como destino de dicha alarma**
1. Complete los pasos 1 a 9 tal como se especifica en [Creación de una alarma de CloudWatch basada en un umbral estático](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) en la *Guía del usuario de Amazon CloudWatch*.
1. En la sección **Acción de Systems Manager**, elija **Agregar acción de Systems Manager OpsCenter**.
1. Elija **OpsItems**.
1. En **Gravedad**, elija de 1 a 4.
1. (Opcional) En **Categoría**, elija una categoría para el OpsItem.
1. Complete los pasos 11 a 13 tal como se especifica en [Creación de una alarma de CloudWatch basada en un umbral estático](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) en la *Guía del usuario de Amazon CloudWatch*.
1. Elija **Next** (Siguiente) y complete el asistente.
**Para editar una alarma existente y configurar Systems Manager como destino de dicha alarma**
1. Abra la consola de CloudWatch en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, elija **Alarmas**.
1. Seleccione la alarma y, a continuación, elija **Actions** (Acciones), **Edit** (Editar).
1. Cambie la configuración en las secciones **Metrics** (Métricas) y **Conditions** (Condiciones) y, a continuación, elija **Next** (Siguiente) (opcional).
1. En la sección **Systems Manager**, elija **Add Systems Manager OpsCenter action** (Agregar acción de Systems Manager OpsCenter).
1. En **Severity** (Severidad), elija un número.
**nota**
La severidad es un valor definido por el usuario. Usted o su organización determinan lo que significa cada valor de severidad y cualquier acuerdo de nivel de servicio asociado a cada severidad.
1. En **Category** (Categoría), elija una opción (opcional).
1. Elija **Next** (Siguiente) y complete el asistente.
# Configuración de una alarma de CloudWatch existente para crear OpsItems (mediante programación)
Puede configurar alarmas de Amazon CloudWatch para crear OpsItems mediante la AWS Command Line Interface (AWS CLI), las plantillas de AWS CloudFormation o los fragmentos de código Java.
**Topics**
+ [
## Antes de empezar
](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)
+ [
## Configuración de alarmas de CloudWatch para crear OpsItems (AWS CLI)
](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-manually-configure-cli)
+ [
## Configuración de alarmas de CloudWatch para crear o actualizar OpsItems (CloudFormation)
](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-CloudFormation)
+ [
## Configuración de alarmas de CloudWatch para crear o actualizar OpsItems (Java)
](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-java)
## Antes de empezar
Si edita mediante programación una alarma existente o crea una alarma que crea OpsItems, debe especificar un nombre de recurso de Amazon (ARN). Este ARN identifica Systems Manager OpsCenter como el objetivo de OpsItems creado a partir de la alarma. Puede personalizar el ARN para que los OpsItems creados a partir de la alarma incluyan información específica, como la severidad o la categoría. Cada ARN incluye la información que se describe en la tabla siguiente.
****
| Parámetro | Details |
| --- | --- |
| `Region` (obligatorio) | La Región de AWS donde existe la alarma. Por ejemplo: `us-west-2`. Para obtener más información acerca de las Regiones de AWS donde puede utilizar OpsCenter, consulte [Cuotas y puntos de enlace de AWS Systems Manager](https://docs.aws.amazon.com/general/latest/gr/ssm.html). |
| `account_ID` (obligatorio) | El mismo ID de Cuenta de AWS utilizado para crear la alarma. Por ejemplo: `123456789012`. El ID de cuenta debe ir seguido de dos puntos (`:`) y el parámetro `opsitem` como se muestra en los siguientes ejemplos. |
| `severity` (obligatorio) | Un nivel de severidad definido por el usuario para OpsItems creados a partir de la alarma. Valores válidos: `1`, `2`, `3`, `4` |
| `Category` (opcional) | Una categoría para los OpsItems creados a partir de la alarma. Valores válidos: `Availability`, `Cost`, `Performance`, `Recovery` y `Security`. |
Cree el ARN utilizando la siguiente sintaxis. Este ARN no incluye el parámetro opcional `Category`.
```
arn:aws:ssm:Region:account_ID:opsitem:severity
```
A continuación se muestra un ejemplo.
```
arn:aws:ssm:us-west-2:123456789012:opsitem:3
```
Para crear un ARN que utilice el parámetro opcional `Category`, utilice la siguiente sintaxis.
```
arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name
```
A continuación se muestra un ejemplo.
```
arn:aws:ssm:us-west-2:123456789012:opsitem:3#CATEGORY=Security
```
## Configuración de alarmas de CloudWatch para crear OpsItems (AWS CLI)
Este comando requiere que especifique un ARN para el parámetro `alarm-actions`. Para obtener más información acerca de cómo crear el ARN, consulte [Antes de empezar](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).
**Para configurar CloudWatch a fin de crear OpsItems (AWS CLI)**
1. Si aún no lo ha hecho, instale y configure la AWS Command Line Interface (AWS CLI).
Para obtener más información, consulte [Instalación o actualización de la última versión de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
1. Ejecute el siguiente comando a fin de recopilar información sobre la alarma que desea configurar.
```
aws cloudwatch describe-alarms --alarm-names "alarm name"
```
1. Ejecute el siguiente comando para actualizar una alarma. Reemplace cada *example resource placeholder* con su propia información.
```
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
```
A continuación se muestra un ejemplo.
------
#### [ 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
```
------
## Configuración de alarmas de CloudWatch para crear o actualizar OpsItems (CloudFormation)
En esta sección, se incluyen plantillas de AWS CloudFormation que puede utilizar para configurar las alarmas de CloudWatch para crear o actualizar OpsItems de manera automática. Cada plantilla requiere que especifique un ARN para el parámetro `AlarmActions`. Para obtener más información acerca de cómo crear el ARN, consulte [Antes de empezar](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).
**Alarma métrica**: utilice la siguiente plantilla de CloudFormation para crear o actualizar una alarma métrica de CloudWatch. La alarma especificada en esta plantilla monitorea las comprobaciones de estado de las instancias de Amazon Elastic Compute Cloud (Amazon EC2). Si la alarma ingresa en el estado `ALARM`, crea un OpsItem en 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"}}]
}
}
}
}
```
**Alarma compuesta**: utilice la siguiente plantilla de CloudFormation para crear o actualizar una alarma compuesta. Una alarma compuesta consta de múltiples alarmas métricas. Si la alarma ingresa en el estado `ALARM`, crea un OpsItem en 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"
}
}
}
```
## Configuración de alarmas de CloudWatch para crear o actualizar OpsItems (Java)
Esta sección incluye fragmentos de código Java que puede usar para configurar alarmas de CloudWatch para crear o actualizar OpsItems de manera automática. Cada fragmento requiere que especifique un ARN para el parámetro `validSsmActionStr`. Para obtener más información acerca de cómo crear el ARN, consulte [Antes de empezar](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).
**Una alarma específica**: utilice el siguiente fragmento de código Java para crear o actualizar una alarma de CloudWatch. La alarma especificada en esta plantilla monitorea las verificaciones del estado de las instancias de Amazon EC2. Si la alarma ingresa en el estado `ALARM`, crea un OpsItem en 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);
}
```
**Actualizar todas las alarmas**: utilice el siguiente fragmento de código Java para actualizar todas las alarmas de CloudWatch en su Cuenta de AWS para crear OpsItems cuando una alarma ingresa en el estado `ALARM`.
```
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;
}
}
}
```