Acerca de los destinos

Puede gestionar objetivos Monitoring en su cuenta utilizando la interfaz de usuario IBM Cloud Metrics Routing, la CLI IBM Cloud Metrics Routing, la API REST IBM Cloud Metrics Routing, el proveedor Terraform IBM Cloud Metrics Routing y los módulos Terraform IBM(TIM)para IBM Cloud Metrics Routing. Un objetivo es un recurso en el que puedes recopilar métricas. El recurso puede estar ubicado en la misma cuenta de IBM Cloud donde se generan las métricas o en una cuenta diferente.

Visión general sobre el funcionamiento de los destinos en la cuenta

Tenga en cuenta la siguiente información sobre destinos:

  • Los destinos son regionales bajo una cuenta y se puede acceder a ellos desde cualquier punto final de API IBM Cloud Metrics Routing regional.

  • Puede definir un destino en cualquiera de las ubicaciones soportadas donde esté disponible IBM Cloud Metrics Routing. Para obtener más información, consulte Ubicaciones.

  • Puedes configurar hasta 16 objetivos en cada cuenta.

  • Puede configurar hasta dos destinos predeterminados para cada cuenta de IBM Cloud.

    Los destinos predeterminados recopilan métricas de las ubicaciones en las que no especifica en la cuenta dónde direccionar las métricas que se generan en esa ubicación.

  • La información sobre los destinos se almacena como metadatos en las ubicaciones primaria y de copia de seguridad que ha establecido para la cuenta IBM Cloud. La información que se almacena incluye detalles sobre el recurso destinatiion y las credenciales para enviar métricas.

    La ubicación primaria de los metadatos debe establecerse antes de configurar un objetivo.

    Si no configura una ubicación de metadatos primaria, la ubicación se establece en la ubicación donde define el primer destino en la cuenta. Para obtener más información, consulte Configuración de valores de cuenta.

  • Puede utilizar puntos finales públicos y privados para gestionar destinos. Para obtener más información sobre la lista de puntos finales disponibles, consulte Puntos finales.

    • Puede gestionar objetivos desde la red privada utilizando un punto final de API con el siguiente formato: https://private.REGION.metrics-router.cloud.ibm.com

    • Puede gestionar objetivos desde la red pública utilizando un punto final de API con el siguiente formato: https://REGION.metrics-router.cloud.ibm.com

    • Puede inhabilitar los puntos finales públicos actualizando los valores de la cuenta. Para obtener más información, consulte Imposición de puntos finales privados.

  • El nombre del destino debe tener 1000 caracteres o menos y no puede incluir ningún carácter especial que no sea espacio, guión -, punto ., guión bajo _, y dos puntos :.

    El nombre no debe incluir ninguna información de identificación personal (PII).

Tipos de destinos

Puede configurar cualquiera de los siguientes tipos de destino:

Lista de objetivos
Destino Tipo Ámbito Descripción
IBM Cloud Monitoring sysdig-monitor Account Utilice este objetivo para consolidar datos de series temporales en la región de las operaciones primarias.

Acceso de IAM

Para gestionar destinos, asegúrese de que tiene los permisos de IAM correctos para configurar IBM Cloud Metrics Routing.

Para permitir que el servicio IBM Cloud Metrics Routing envíe métricas a los destinos de Monitoring, debe tener configurado un servicio para la autorización de servicio en la cuenta donde se encuentra el destino. Para obtener más información, consulte Gestión de autorizaciones para otorgar acceso entre servicios.

Permisos de IAM

En la tabla siguiente se listan las acciones de IAM, su ámbito y los roles necesarios para gestionar rutas.

Ámbitos de actuación y funciones de IAM para la gestión de objetivos
Tarea Acción IAM Ámbito de política de IAM Roles de IAM
Crear un destino metrics-router.target.create Región Administrator
Editor
Listar todos los destinos metrics-router.target.list Cuenta Administrator
Editor
Operator
Viewer
Obtener detalles de un objetivo metrics-router.target.read Región Administrator
Editor
Operator
Viewer
Modificar un destino metrics-router.target.update Región Administrator
Editor
Suprimir un destino metrics-router.target.delete Región Administrator
Editor

Cuando utilice la CLI, observe que necesita el rol metrics-router.target.list para crear, leer, actualizar o suprimir un destino.

Sucesos de auditoría

En la tabla siguiente se listan las acciones de IAM, su ámbito y los roles necesarios para gestionar rutas.

Seguimiento de actividades Auditoría Acción
Tarea Seguimiento de actividades Auditoría Acción
Crear un destino metrics-router.target.create
Listar todos los destinos metrics-router.target.list
Obtener detalles de un objetivo metrics-router.target.read
Modificar un destino metrics-router.target.update
Suprimir un destino metrics-router.target.delete

Gestión de objetivos mediante la interfaz de usuario

Puede gestionar su definición de objetivo mediante la IU IBM Cloud Metrics Routing. Para obtener más información, consulte Gestión de objetivos.

Requisitos previos de la CLI

Antes de utilizar la CLI para gestionar destinos, lleve a cabo los pasos siguientes:

  1. Asegúrese de que tiene los permisos de IAM correctos para configurar IBM Cloud Metrics Routing.

  2. Instale la CLI de IBM Cloud.

  3. Instale la CLI de IBM Cloud Metrics Routing.

mandatos de CLI

En la tabla siguiente se listan las acciones que puede ejecutar para gestionar destinos:

Acciones objetivo
Acción Mandato
Create a target ibmcloud metrics-router target create
Update a target ibmcloud metrics-router target update
Delete a target ibmcloud metrics-router target rm
Read a target ibmcloud metrics-router target get
List all targets ibmcloud metrics-router target ls

Para obtener más información, consulte CLI deIBM Cloud Metrics Routing v3.

Requisitos previos de la API

Antes de utilizar la API para gestionar objetivos, complete los siguientes pasos:

  1. Asegúrese de que tiene los permisos de IAM correctos para configurar IBM Cloud Metrics Routing.

  2. Obtenga una señal de acceso IAM. Para obtener más información, consulte Recuperación de señales de acceso de IAM.

  3. Identifique el punto final de API en la región en la que tiene previsto configurar o gestionar un destino. Para obtener más información, consulte Puntos finales.

Métodos de API

En la tabla siguiente se listan las acciones que puede ejecutar para gestionar destinos:

Dirija las acciones utilizando la IBM Cloud Metrics Routing API REST
Acción Método de API REST API_URL
Create a target POST <ENDPOINT>/api/v3/targets
Update a target PATCH <ENDPOINT>/api/v3/targets/<TARGET_ID>
Delete a target DELETE <ENDPOINT>/api/v3/targets/<TARGET_ID>
Read a target GET <ENDPOINT>/api/v3/targets/<TARGET_ID>
List all targets GET <ENDPOINT>/api/v3/targets

Para obtener más información, consulte API deIBM Cloud Metrics Routing v3.

Códigos de respuesta de HTTP

Cuando se utiliza la API REST de IBM Cloud Metrics Routing, es posible obtener códigos de respuesta HTTP estándar para indicar si un método se ha completado satisfactoriamente.

  • Una respuesta de 200 siempre indica éxito.
  • Una respuesta 4xx indica una anomalía.
  • Una respuesta 5xx normalmente indica un error interno del sistema.

Consulte la tabla siguiente para ver algunos códigos de respuesta HTTP:

Lista de códigos de respuesta HTTP
Código de estado Estado Descripción
200 OK La solicitud se ha realizado correctamente.
201 OK La solicitud se ha realizado correctamente. Se crea un recurso.
204 OK El objetivo se ha eliminado correctamente.
400 Solicitud errónea La solicitud no ha sido satisfactoria. Es posible que falte un parámetro que sea necesario.
401 No autorizado La solicitud de autorización falla.
403 Prohibido La operación está prohibida debido a permisos insuficientes.
404 No encontrado El recurso solicitado no existe o ya se ha suprimido.
429 Demasiadas solicitudes Demasiadas solicitudes han llegado a la API demasiado rápido.
500 Error de servidor interno Algo ha fallado en el proceso de IBM Cloud Metrics Routing.