View a markdown version of this page

Creación de canalizaciones - Amazon CloudWatch
Creación de una canalización de registrosCreación de una canalización de métricas

Creación de canalizaciones

Las canalizaciones de CloudWatch permiten crear canalizaciones tanto para datos de registro como para datos de métricas. En las siguientes secciones se describe cómo crear cada tipo de canalización.

Creación de una canalización de registros

El asistente de configuración de canalizaciones guía el proceso de creación de una canalización de datos de registro.

  1. En Configuración general, proporcione los detalles del origen de datos, lo que incluye el nombre y el tipo del origen. También puede especificar las etiquetas de canalización y el nombre de la canalización.

  2. En Destino, especifique los detalles del destino. En las canalizaciones de registros, Registros de CloudWatch es el único destino compatible. En las canalizaciones de métricas, Métricas de CloudWatch es el único destino compatible.

  3. En Procesador, agregue los procesadores y analizadores que desee. Un analizador es un primer paso obligatorio para determinados tipos de datos. Puede llevar a cabo un análisis personalizado con procesadores como Grok o CSV. Puede utilizar el procesador de búsqueda para enriquecer los eventos de registro con datos de una tabla de búsqueda de Registros de Amazon CloudWatch. Los procesadores que no son compatibles con el tipo de datos están desactivados.

    Para configurar los procesadores mediante lenguaje natural, active la opción de ayuda de la IA. Ingrese una descripción de las transformaciones de registro que necesita y CloudWatch Pipelines generará la configuración del procesador automáticamente. En el caso de los registros suministrados por AWS, también se genera un ejemplo de evento de registro para que pueda verificar el resultado antes de implementarlos. Puede revisar y editar la configuración generada antes de crear la canalización.

    importante

    Para utilizar una configuración de procesador asistida por IA, debe tener el permiso de IAM logs:GeneratePipeline. Para obtener más información, consulte Permisos de la configuración de procesadores asistida por IA.

    También puede agregar reglas de procesamiento condicional a los procesadores compatibles mediante el parámetro when. El procesamiento condicional le permite controlar las entradas de registro sobre las que actúa un procesador. Para obtener información sobre la sintaxis de la expresión y los procesadores compatibles, consulte Sintaxis de expresiones para el procesamiento condicional.

    Para conservar copias no modificadas de los datos de registro con fines de auditoría o cumplimiento, active la opción Conservar el registro original. Cuando se habilita, las canalizaciones de CloudWatch almacenan automáticamente una copia de cada evento de registro sin procesar antes de que se aplique cualquier transformación en el campo del sistema @original_message del evento. Esto garantiza que los datos originales estén siempre disponibles para auditorías o investigaciones, incluso después de que los procesadores modifiquen los eventos del registro. La opción Conservar el registro original solo está disponible para las canalizaciones con un origen de registro suministrado por CloudWatch.

  4. En Revisar y crear, revise la configuración de la canalización. Si le satisface la configuración, seleccione Crear canalización para iniciar la implementación y la creación de los recursos de la canalización. La creación de la canalización tarda hasta 5 minutos en función del tipo de origen. Al finalizar, accederá a la pestaña Canalizaciones de la consola de ingesta.

importante

Las configuraciones de los procesadores de las canalizaciones se registran en los eventos de AWS CloudTrail con fines de auditoría y cumplimiento. Para proteger la información confidencial, no incluya contraseñas, claves de API ni otra información confidencial en las configuraciones de los procesadores.

Creación de una canalización de métricas

Puede crear una canalización de métricas mediante la consola de CloudWatch o AWS CLI. Con una canalización de métricas, puede procesar los datos de métricas de CloudWatch, aplicar transformaciones y reenviar las métricas procesadas a CloudWatch.

Para crear una canalización de métricas mediante la consola

Utilice el siguiente procedimiento para crear una canalización de métricas en la consola de CloudWatch.

  1. Abra la consola de CloudWatch y, en el panel de navegación, seleccione Ingesta y Canalizaciones.

  2. Seleccione Create pipeline.

  3. En el tipo de origen, seleccione Métricas de CloudWatch (OTel).

  4. Configure los criterios de selección para especificar las métricas que procesará la canalización. Los criterios de selección utilizan rutas de atributos de OTel, como resource.attributes, metric.name y datapoint.attributes. Todos los criterios utilizan la semántica AND, es decir, todos deben coincidir.

  5. En Procesador, agregue hasta 20 procesadores para transformar los datos de métricas.

  6. En Revisar y crear, revise la configuración de la canalización y seleccione Crear canalización.

Para crear una canalización de métricas mediante AWS CLI

Utilice el comando create-telemetry-pipeline para crear una canalización de métricas desde AWS CLI.

aws observabilityadmin create-telemetry-pipeline \
    --pipeline-configuration-body file://config.yaml

En el siguiente ejemplo se muestra un archivo de configuración YAML que define una canalización de métricas con un origen, un procesador y un receptor.

pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "payment-service"'
            - 'metric.name == "http.server.request.duration"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["team"]
            value: "platform-engineering"
  sink:
    - cloudwatch_metrics: {}

Cuando se crea la canalización, devuelve un ARN con el siguiente formato:

arn:aws:observabilityadmin:region:accountId:telemetry-pipeline/pipelineID
nota

Métricas de CloudWatch es el único destino compatible con las canalizaciones de métricas.

Operaciones de la API compatibles

En la siguiente tabla se enumeran las operaciones de la API que puede utilizar para administrar las canalizaciones de métricas.

Operación Descripción
CreateTelemetryPipeline Crea una canalización de métricas nueva.
GetTelemetryPipeline Recupera los detalles de una canalización de métricas específica.
ListTelemetryPipelines Enumera todas las canalizaciones de métricas de la cuenta.
DeleteTelemetryPipeline Elimina una canalización de métricas.
ValidateTelemetryPipelineConfiguration Valida la configuración de una canalización antes de crearla.
UpdateTelemetryPipeline Actualiza la configuración de una canalización de métricas existente.