Esta es la guía para AWS CDK desarrolladores de la versión 2. La versión anterior del CDK v1 entró en mantenimiento el 1 de junio de 2022 y dejó de ofrecer soporte el 1 de junio de 2023.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Configurar una CloudWatch alarma
Usa el paquete aws-cloudwatch para configurar las CloudWatch alarmas de Amazon en las métricas. CloudWatch Puede usar métricas predefinidas o crear las suyas propias.
Utilizar una métrica existente
Muchos módulos de AWS Construct Library permiten configurar una alarma en una métrica existente pasando el nombre de la métrica a un método práctico de una instancia de un objeto que tiene métricas. Por ejemplo, dada una cola de Amazon SQS, puede obtener la métrica del método metric () ApproximateNumberOfMessagesVisiblede la cola:
- TypeScript
-
const metric = queue.metric("ApproximateNumberOfMessagesVisible");
- JavaScript
-
const metric = queue.metric("ApproximateNumberOfMessagesVisible");
- Python
-
metric = queue.metric("ApproximateNumberOfMessagesVisible")
- Java
-
Metric metric = queue.metric("ApproximateNumberOfMessagesVisible");
- C#
-
var metric = queue.Metric("ApproximateNumberOfMessagesVisible");
Crear su propia métrica
Cree su propia métrica de la siguiente manera, donde el valor del espacio de nombres debe ser algo parecido a AWS/SQS para una cola de Amazon SQS. También debe especificar el nombre y la dimensión de la métrica:
- TypeScript
-
const metric = new cloudwatch.Metric({
namespace: 'MyNamespace',
metricName: 'MyMetric',
dimensionsMap: { MyDimension: 'MyDimensionValue' }
});
- JavaScript
-
const metric = new cloudwatch.Metric({
namespace: 'MyNamespace',
metricName: 'MyMetric',
dimensionsMap: { MyDimension: 'MyDimensionValue' }
});
- Python
-
metric = cloudwatch.Metric(
namespace="MyNamespace",
metric_name="MyMetric",
dimensionsMap=dict(MyDimension="MyDimensionValue")
)
- Java
-
Metric metric = Metric.Builder.create()
.namespace("MyNamespace")
.metricName("MyMetric")
.dimensionsMap(java.util.Map.of( // Java 9 or later
"MyDimension", "MyDimensionValue"))
.build();
- C#
-
var metric = new Metric(this, "Metric", new MetricProps
{
Namespace = "MyNamespace",
MetricName = "MyMetric",
Dimensions = new Dictionary<string, object>
{
{ "MyDimension", "MyDimensionValue" }
}
});
Crear la alarma
Una vez que tenga una métrica, ya sea una existente o una que haya definido, puede crear una alarma. En este ejemplo, la alarma se activa cuando hay más de 100 unidades de la métrica en dos de los últimos tres períodos de evaluación. Puede utilizar comparaciones como el valor inferior al de sus alarmas a través de la comparisonOperator
propiedad. G reater-than-or-equal -to es el AWS CDK valor predeterminado, por lo que no necesitamos especificarlo.
- TypeScript
-
const alarm = new cloudwatch.Alarm(this, 'Alarm', {
metric: metric,
threshold: 100,
evaluationPeriods: 3,
datapointsToAlarm: 2,
});
- JavaScript
-
const alarm = new cloudwatch.Alarm(this, 'Alarm', {
metric: metric,
threshold: 100,
evaluationPeriods: 3,
datapointsToAlarm: 2
});
- Python
-
alarm = cloudwatch.Alarm(self, "Alarm",
metric=metric,
threshold=100,
evaluation_periods=3,
datapoints_to_alarm=2
)
- Java
-
import software.amazon.awscdk.services.cloudwatch.Alarm;
import software.amazon.awscdk.services.cloudwatch.Metric;
Alarm alarm = Alarm.Builder.create(this, "Alarm")
.metric(metric)
.threshold(100)
.evaluationPeriods(3)
.datapointsToAlarm(2).build();
- C#
-
var alarm = new Alarm(this, "Alarm", new AlarmProps
{
Metric = metric,
Threshold = 100,
EvaluationPeriods = 3,
DatapointsToAlarm = 2
});
Una forma alternativa de crear una alarma es usar el método createAlarm () de la métrica, que tiene básicamente las mismas propiedades que el constructor. Alarm
No es necesario que pases la métrica, porque ya la conoces.
- TypeScript
-
metric.createAlarm(this, 'Alarm', {
threshold: 100,
evaluationPeriods: 3,
datapointsToAlarm: 2,
});
- JavaScript
-
metric.createAlarm(this, 'Alarm', {
threshold: 100,
evaluationPeriods: 3,
datapointsToAlarm: 2,
});
- Python
-
metric.create_alarm(self, "Alarm",
threshold=100,
evaluation_periods=3,
datapoints_to_alarm=2
)
- Java
-
metric.createAlarm(this, "Alarm", new CreateAlarmOptions.Builder()
.threshold(100)
.evaluationPeriods(3)
.datapointsToAlarm(2)
.build());
- C#
-
metric.CreateAlarm(this, "Alarm", new CreateAlarmOptions
{
Threshold = 100,
EvaluationPeriods = 3,
DatapointsToAlarm = 2
});