• 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). # Create OpsItems Después de configurar OpsCenter, una herramienta de AWS Systems Manager, e integrarlo con sus Servicios de AWS, los Servicios de AWS crean OpsItems automáticamente en función de reglas, eventos o alarmas predeterminados. Puede ver los estados y los niveles de gravedad de las reglas predeterminadas de Amazon EventBridge. Si es necesario, puede crear o editar estas reglas desde Amazon EventBridge. También puede ver las alarmas desde Amazon CloudWatch y crear o editar alarmas. Mediante reglas y alarmas, puede configurar los eventos para los que desee generar OpsItems automáticamente. Cuando el sistema crea un OpsItem, se encuentra en estado **Abierto**. Puede cambiar el estado a **En curso** al iniciar la investigación del OpsItem y a **Resuelto** después de corregir el OpsItem. Para obtener más información acerca de cómo configurar alarmas y reglas en los Servicios de AWS para crear OpsItems y cómo crear OpsItems de forma manual, consulte los siguientes temas. **Topics** + [Configuración de las reglas de EventBridge para crear OpsItems](OpsCenter-automatically-create-OpsItems-2.md) + [Configuración de alarmas de CloudWatch para crear OpsItems](OpsCenter-create-OpsItems-from-CloudWatch-Alarms.md) + [Crear OpsItems manualmente](OpsCenter-manually-create-OpsItems.md) # Configuración de las reglas de EventBridge para crear OpsItems Cuando Amazon EventBridge recibe un evento, crea un OpsItem nuevo en función de reglas predeterminadas. Puede crear una regla o editar una regla existente para establecer OpsCenter como destino de un evento de EventBridge. Para obtener información acerca de cómo crear una regla de evento, consulte [Creación de una regla para un Servicio de AWS](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) en la *Guía del usuario de Amazon EventBridge*. **Para configurar una regla de EventBridge para crear OpsItems en OpsCenter** 1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. En el panel de navegación, seleccione **Reglas**. 1. En la página **Rules** (Reglas), para **Event bus** (Buses de eventos), elija **default** (predeterminado). 1. En **Reglas**, para elegir una regla, seleccione la casilla de verificación situada junto a su nombre. 1. Seleccione el nombre de la regla para abrir la página de detalles. En **Detalles de regla**, verifique que **Estado** tenga el valor **Habilitado**. **nota** Si es necesario, puede actualizar el estado con **Editar**, en la esquina superior derecha de la página. 1. Elija la pestaña **Destinos**. 1. En la pestaña **Targets**, seleccione **Edit**. 1. Para los **tipos de destino**, seleccione **Servicio de AWS**. 1. En **Select a target** (Seleccione un destino), elija **Systems Manager OpsItem**. 1. Si hay muchos tipos de destino, EventBridge necesita permiso para enviar eventos al destino. En estos casos, EventBridge puede crear el rol de AWS Identity and Access Management (IAM) necesario para que se ejecute la regla: + Para crear un rol de IAM automáticamente, elija **Creación de un nuevo rol para este recurso específico**. + Para utilizar un rol de IAM creado con el objetivo de darle permiso a EventBridge para crear OpsItems en OpsCenter, elija **Use existing role** (Utilizar rol existente). 1. En **Configuración adicional**, en **Configurar entrada de destino**, elija **Transformador de entrada**. Puede utilizar la opción **Transformador de entrada** para especificar una cadena de deduplicación y demás información importante para OpsItems, como título y gravedad. 1. Elija **Configurar transformador de entrada**. 1. En **Transformador de entrada de destino**, en **Ruta de entrada**, especifique los valores que se van a analizar del evento que se desencadena. Por ejemplo, para analizar la hora de inicio, de finalización y otros detalles del evento que desencadena la regla, utilice el siguiente JSON. ``` { "end-time": "$.detail.EndTime", "failure-cause": "$.detail.cause", "resources": "$.resources[0]", "source": "$.detail.source", "start-time": "$.detail.StartTime" } ``` 1. En **Template (Plantilla)**, especifique la información que se va a enviar al destino. Por ejemplo, utilice el siguiente JSON para pasar información a OpsCenter. La información se utiliza para crear un OpsItem. **nota** Si la plantilla de entrada está en formato JSON, el valor del objeto de la plantilla no puede incluir comillas. Por ejemplo, los valores de los recursos, la causa del error, la fuente, la hora de inicio y la hora de finalización no pueden estar entre comillas. ``` { "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": } } } ``` Para obtener más información acerca de estos campos, consulte [Transforming target input](https://docs.aws.amazon.com/eventbridge/latest/userguide/transform-input.html) (Transformar la entrada de destino) en la *Guía del usuario de Amazon EventBridge*. 1. Seleccione **Confirmar**. 1. Elija **Siguiente**. 1. Elija **Siguiente**. 1. Elija **Actualizar regla**. Después de crear un OpsItem a partir de un evento, puede ver los detalles del evento abriendo el OpsItem y deslizando el cursor hacia abajo hasta la sección **Private operational data (Datos operativos privados)**. Para obtener información acerca de cómo configurar las opciones en un OpsItem, consulte [Administración de OpsItems](OpsCenter-working-with-OpsItems.md). # 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; } } } ``` # Crear OpsItems manualmente Cuando encuentre un problema operativo, puede crear manualmente un OpsItem desde OpsCenter, una herramienta de AWS Systems Manager, para administrar y resolver el problema. Si configura OpsCenter para la administración entre cuentas, un administrador delegado de Systems Manager o una cuenta de administración de AWS Organizations puede crear OpsItems para cuentas de miembros. Para obtener más información, consulte [(Opcional) Configuración manual de OpsCenter para administrar OpsItems de forma centralizada entre cuentas](OpsCenter-getting-started-multiple-accounts.md). Puede crear OpsItems mediante la consola de AWS Systems Manager, la AWS Command Line Interface (AWS CLI) o AWS Tools for Windows PowerShell. **Topics** + [Creación manual de OpsItems (consola)](OpsCenter-creating-OpsItems-console.md) + [Creación de OpsItems manualmente (AWS CLI)](OpsCenter-creating-OpsItems-CLI.md) + [Creación de OpsItems manualmente (PowerShell)](OpsCenter-creating-OpsItems-Powershell.md) # Creación manual de OpsItems (consola) Puede crear OpsItems de forma manual mediante la consola de AWS Systems Manager. Cuando crea un OpsItem, se muestra en su cuenta de OpsCenter. Si configura OpsCenter para la administración entre cuentas, OpsCenter ofrece al administrador delegado o a la cuenta de administración la opción de crear OpsItems para las cuentas de miembros seleccionadas. Para obtener más información, consulte [(Opcional) Configuración manual de OpsCenter para administrar OpsItems de forma centralizada entre cuentas](OpsCenter-getting-started-multiple-accounts.md). **Para crear un OpsItem con la consola de AWS Systems Manager** 1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. En el panel de navegación, elija **OpsCenter**. 1. Seleccione **Crear OpsItem**. Si este botón no aparece, elija la pestaña **OpsItems** y, a continuación, elija **Crear OpsItem**. 1. (Opcional) Elija **Otra cuenta** y, a continuación, elija la cuenta en la que desea crear el OpsItem. **nota** Este paso es obligatorio si crea OpsItems para una cuenta de miembro. 1. En **Título**, escriba un nombre descriptivo que le ayude a comprender la finalidad del OpsItem. 1. En **Source** (Origen), ingrese el tipo de recurso de AWS afectado u otro tipo de información de origen para ayudar a los usuarios a comprender el origen del OpsItem. **nota** No se puede editar el campo **Origen** una vez creado el OpsItem. 1. En **Priority** (Prioridad), elija el nivel de prioridad (opcional). 1. En **Severity** (Severidad), elija el nivel de severidad (opcional). 1. En **Category** (Categoría), elija una categoría (opcional). 1. En **Descripción**, escriba información acerca de este OpsItem, incluidos (si corresponden) los pasos para reproducir el problema. **nota** La consola admite la mayoría de los formatos de Markdown del campo de descripción OpsItem. Para obtener más información, consulte [Uso de Markdown en la consola](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html) en la *Introducción a la Consola de administración de AWS en la Guía de introducción.* 1. En **Cadena de deduplicación**, ingrese las palabras que el sistema puede usar para comprobar si hay OpsItems duplicados. Para obtener más información sobre las cadenas de deduplicación, consulte [Administración de OpsItems duplicados](OpsCenter-working-deduplication.md). 1. (Opcional) En **Notificaciones**, especifique el nombre de recurso de Amazon (ARN) del tema de Amazon SNS donde desea que se envíen notificaciones cuando se actualice este OpsItem. Debe especificar un ARN de Amazon SNS que se encuentre en la misma Región de AWS que el OpsItem. 1. (Opcional) En **Recursos relacionados**, elija **Agregar** para especificar el ID o ARN del recurso afectado y los recursos relacionados. 1. Seleccione **Crear OpsItem**. Si se realiza correctamente, la página mostrará el OpsItem. Cuando una cuenta de administración o administrador delegado crea un OpsItem para cuentas de miembros seleccionadas, los nuevos OpsItems se muestran en el OpsCenter de las cuentas de administrador y miembros. Para obtener información acerca de cómo configurar las opciones en un OpsItem, consulte [Administración de OpsItems](OpsCenter-working-with-OpsItems.md). # Creación de OpsItems manualmente (AWS CLI) En el siguiente procedimiento se describe cómo se crea un OpsItem con AWS Command Line Interface (AWS CLI). **Para crear un OpsItem mediante la 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. Abra la AWS CLI y ejecute el siguiente comando para crear un OpsItem. Reemplace cada *example resource placeholder* con su propia información. ``` 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" ``` **Especificar los datos operativos de un archivo** Al crear un OpsItem, puede especificar los datos operativos de un archivo. El archivo debe ser un archivo JSON y su contenido debe tener el siguiente formato. ``` { "key_name": { "Type": "SearchableString", "Value": "Up to 20 KB of data" } } ``` A continuación se muestra un ejemplo. ``` 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" ``` **nota** Para obtener información acerca de cómo se ingresan los parámetros con formato JSON en la línea de comandos en diferentes sistemas operativos locales, consulte [Uso de comillas con cadenas en AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) en la *Guía del usuario de AWS Command Line Interface*. El sistema devuelve información similar a la siguiente. ``` { "OpsItemId": "oi-1a2b3c4d5e6f" } ``` 1. Ahora ejecute el siguiente comando para ver detalles sobre el OpsItem que ha creado. ``` aws ssm get-ops-item --ops-item-id ID ``` El sistema devuelve información similar a la siguiente. ``` { "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. Ejecute el siguiente comando para actualizar el OpsItem. Este comando cambia el estado de `Open` (valor predeterminado) a `InProgress`. ``` aws ssm update-ops-item --ops-item-id ID --status InProgress ``` El comando no genera ningún resultado. 1. Ejecute el siguiente comando de nuevo para comprobar que el estado cambia a `InProgress`. ``` aws ssm get-ops-item --ops-item-id ID ``` ## Ejemplos de creación de un OpsItem En los siguientes ejemplos de código se muestra cómo crear un OpsItem mediante el portal de administración de Linux, macOS o Windows Server. **Portal de administración de Linux o macOS** El siguiente comando crea un OpsItem cuando un disco de instancia de Amazon Elastic Compute Cloud (Amazon EC2) está lleno. ``` 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" ``` El comando siguiente utiliza la clave `/aws/resources` en `OperationalData` para crear un OpsItem con un recurso relacionado de Amazon DynamoDB. ``` 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" ``` El siguiente comando utiliza la clave `/aws/automations` en `OperationalData` para crear un OpsItem que especifique el documento `AWS-ASGEnterStandby` como manual de procedimientos de Automatización asociado. ``` 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** El siguiente comando crea un OpsItem cuando una instancia de Amazon Relational Database Service (Amazon RDS) no responde. ``` 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" ``` El comando siguiente utiliza la clave `/aws/resources` en `OperationalData` para crear un OpsItem con un recurso relacionado con la instancia de Amazon 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\"}} ``` El siguiente comando utiliza la clave `/aws/automations` en `OperationalData` para crear un OpsItem que especifique el manual de procedimientos `AWS-RestartEC2Instance` como manual de procedimientos de Automatización asociado. ``` 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\"}} ``` # Creación de OpsItems manualmente (PowerShell) En el siguiente procedimiento se describe cómo se crea un OpsItem con AWS Tools for Windows PowerShell. **Para crear un OpsItem con AWS Tools for Windows PowerShell** 1. Abra AWS Tools for Windows PowerShell y ejecute el siguiente comando para especificar sus credenciales. ``` Set-AWSCredentials –AccessKey key-name –SecretKey key-name ``` 1. Ejecute el siguiente comando para establecer la Región de AWS para la sesión de PowerShell. ``` Set-DefaultAWSRegion -Region Region ``` 1. Ejecute el siguiente comando para crear un nuevo OpsItem. Reemplace cada *example resource placeholder* con su propia información. Este comando especifica un runbook de Automatización de Systems Manager para solucionar este 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 ``` Si se realiza correctamente, el comando genera el ID del nuevo OpsItem. En el siguiente ejemplo, se especifica el nombre de recurso de Amazon (ARN) de una instancia de Amazon Elastic Compute Cloud (Amazon EC2) en mal estado. ``` $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 ```