Uso de alarmas de CloudWatch

Crear una alarma

Para crear una alarma basada en una CloudWatch métrica, CloudWatchClient llama al putMetricAlarm método s con un PutMetricAlarmRequestrelleno con las condiciones de la alarma.

Importaciones

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.cloudwatch.CloudWatchClient;
import software.amazon.awssdk.services.cloudwatch.model.Dimension;
import software.amazon.awssdk.services.cloudwatch.model.PutMetricAlarmRequest;
import software.amazon.awssdk.services.cloudwatch.model.ComparisonOperator;
import software.amazon.awssdk.services.cloudwatch.model.Statistic;
import software.amazon.awssdk.services.cloudwatch.model.StandardUnit;
import software.amazon.awssdk.services.cloudwatch.model.CloudWatchException;

Código

    public static void putMetricAlarm(CloudWatchClient cw, String alarmName, String instanceId) {

        try {
            Dimension dimension = Dimension.builder()
                .name("InstanceId")
                .value(instanceId).build();

            PutMetricAlarmRequest request = PutMetricAlarmRequest.builder()
                .alarmName(alarmName)
                .comparisonOperator(
                        ComparisonOperator.GREATER_THAN_THRESHOLD)
                .evaluationPeriods(1)
                .metricName("CPUUtilization")
                .namespace("AWS/EC2")
                .period(60)
                .statistic(Statistic.AVERAGE)
                .threshold(70.0)
                .actionsEnabled(false)
                .alarmDescription(
                        "Alarm when server CPU utilization exceeds 70%")
                .unit(StandardUnit.SECONDS)
                .dimensions(dimension)
                .build();

            cw.putMetricAlarm(request);
            System.out.printf(
                    "Successfully created alarm with name %s", alarmName);

        } catch (CloudWatchException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
    }

Consulta el ejemplo completo en GitHub.

Mostrar alarmas

Para ver una lista de las CloudWatch alarmas que ha creado, llame al CloudWatchClient describeAlarms método s con un DescribeAlarmsRequestque pueda usar para configurar las opciones del resultado.

Importaciones

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.cloudwatch.CloudWatchClient;
import software.amazon.awssdk.services.cloudwatch.model.CloudWatchException;
import software.amazon.awssdk.services.cloudwatch.model.DescribeAlarmsRequest;
import software.amazon.awssdk.services.cloudwatch.model.DescribeAlarmsResponse;
import software.amazon.awssdk.services.cloudwatch.model.MetricAlarm;

Código

    public static void desCWAlarms( CloudWatchClient cw) {

        try {

            boolean done = false;
            String newToken = null;

            while(!done) {
                DescribeAlarmsResponse response;

                if (newToken == null) {
                    DescribeAlarmsRequest request = DescribeAlarmsRequest.builder().build();
                    response = cw.describeAlarms(request);
                } else {
                    DescribeAlarmsRequest request = DescribeAlarmsRequest.builder()
                        .nextToken(newToken)
                        .build();
                    response = cw.describeAlarms(request);
                }

                for(MetricAlarm alarm : response.metricAlarms()) {
                    System.out.printf("\n Retrieved alarm %s", alarm.alarmName());
                }

                if(response.nextToken() == null) {
                    done = true;
                } else {
                    newToken = response.nextToken();
                }
            }

        } catch (CloudWatchException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
        System.out.printf("Done");
    }

La lista de alarmas se puede obtener llamando MetricAlarms DescribeAlarmsResponseal devuelto pordescribeAlarms.

Los resultados puede que estén paginados. Para recuperar el siguiente lote de resultados, llame a nextToken en el objeto de respuesta y use el valor de token para crear un nuevo objeto de solicitud. Llame entonces al método describeAlarms de nuevo con la nueva solicitud.

nota

También puede recuperar las alarmas de una métrica específica mediante CloudWatchClient el describeAlarmsForMetric método. Su uso es similar a describeAlarms.

Consulte el ejemplo completo en GitHub.

Eliminación de alarmas

Para eliminar CloudWatch las alarmas, llame al CloudWatchClient deleteAlarms método DeleteAlarmsRequestque contenga uno o más nombres de las alarmas que desee eliminar.

Importaciones

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.cloudwatch.CloudWatchClient;
import software.amazon.awssdk.services.cloudwatch.model.CloudWatchException;
import software.amazon.awssdk.services.cloudwatch.model.DeleteAlarmsRequest;

Código

    public static void deleteCWAlarm(CloudWatchClient cw, String alarmName) {

        try {
            DeleteAlarmsRequest request = DeleteAlarmsRequest.builder()
                    .alarmNames(alarmName)
                    .build();

            cw.deleteAlarms(request);
            System.out.printf("Successfully deleted alarm %s", alarmName);

        } catch (CloudWatchException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
    }

Consulta el ejemplo completo en GitHub.

Más información

• Uso de Amazon CloudWatch alarmas en la Guía Amazon CloudWatch del usuario

• PutMetricAlarmen la referencia Amazon CloudWatch de la API

• DescribeAlarmsen la referencia Amazon CloudWatch de la API

• DeleteAlarmsen la referencia Amazon CloudWatch de la API