IBM Cloud Docs
Sobre os destinos

Sobre os destinos

Você pode gerenciar Monitoring alvos em sua conta usando a interface do usuário IBM Cloud Metrics Routing, a CLI IBM Cloud Metrics Routing CLI, a IBM Cloud Metrics Routing API REST e o IBM Cloud Metrics Routing provedor Terraform. Um alvo é um recurso em que você pode coletar métricas. O recurso pode estar localizado na mesma conta IBM Cloud em que as métricas são geradas ou em uma conta diferente.

Entendendo como os destinos funcionam em sua conta

Note as informações a seguir sobre destinos:

  • Os destinos são regionais sob uma conta e podem ser acessados por meio de qualquer terminal de API IBM Cloud Metrics Routing regional.

  • É possível definir um destino em qualquer um dos locais suportados em que o IBM Cloud Metrics Routing está disponível. Para obter mais informações, consulte Locais.

  • Você pode configurar até 16 alvos em cada conta.

  • É possível configurar até dois destinos padrão para cada conta IBM Cloud.

    Os destinos padrão coletam métricas de locais nos quais você não especifica na conta para onde rotear as métricas geradas nesse local.

  • As informações sobre destinos são armazenadas como metadados nos locais primário e de backup que você configura para a conta do IBM Cloud. As informações armazenadas incluem detalhes sobre o recurso de destino e as credenciais para enviar métricas.

    O local de metadados primário deve ser configurado antes de configurar um destino.

    Se você não configurar um local de metadados primários, o local será configurado para o local no qual você define seu primeiro destino na conta Para obter mais informações, consulte Configurando configurações de conta.

  • É possível usar terminais privados e públicos para gerenciar destinos. Para obter mais informações sobre a lista de endpoints disponíveis, consulte Endpoints.

    • Você pode gerenciar alvos da rede privada usando um ponto de extremidade da API com o seguinte formato: https://private.REGION.metrics-router.cloud.ibm.com

    • Você pode gerenciar alvos da rede pública usando um endpoint de API com o seguinte formato: https://REGION.metrics-router.cloud.ibm.com

    • É possível desativar os terminais públicos atualizando as configurações da conta. Para obter mais informações, consulte Impingindo terminais privados

  • O nome do alvo deve ter 1000 caracteres ou menos e não pode incluir nenhum caractere especial além de espaço, traço -, ponto ., sublinhado _ e dois pontos :.

    O nome não deve incluir nenhuma informação de identificação pessoal (PII).

Tipos de destino

Você pode configurar qualquer um dos seguintes tipos de alvo:

Lista de alvos
Target Tipo Scope Descrição
IBM Cloud Monitoring sysdig-monitor Account Use este destino para consolidar dados de série temporal na região de suas operações primárias.

Acesso ao IAM

Para gerenciar destinos, assegure-se de ter as permissões corretas do IAM para configurar o IBM Cloud Metrics Routing.

Para permitir que o serviço IBM Cloud Metrics Routing envie métricas para seus destinos Monitoring, deve-se ter um serviço para autorização de serviço configurado na conta na qual o destino está localizado. Para obter mais informações, consulte Gerenciando autorizações para conceder acesso entre serviços.

Permissões do IAM

A tabela a seguir lista as ações do IAM, o seu escopo e as funções necessárias para gerenciar rotas.

Escopos de ação e funções do IAM para gerenciar metas
Tarefa Ação do IAM escopo da Política do IAM Funções do IAM
Criar um destino metrics-router.target.create Região Administrator
Editor
Listar todos os destinos metrics-router.target.list Conta Administrator
Editor
Operator
Viewer
Obter detalhes de um alvo metrics-router.target.read Região Administrator
Editor
Operator
Viewer
Modificar um destino metrics-router.target.update Região Administrator
Editor
Excluir um destino metrics-router.target.delete Região Administrator
Editor

Ao usar a CLI, observe que você precisa da função metrics-router.target.list para criar, ler, atualizar ou excluir um destino.

Auditando eventos

A tabela a seguir lista as ações do IAM, o seu escopo e as funções necessárias para gerenciar rotas.

Ação de evento de auditoria de rastreamento de atividades
Tarefa Ação de evento de auditoria de rastreamento de atividades
Criar um destino metrics-router.target.create
Listar todos os destinos metrics-router.target.list
Obter detalhes de um alvo metrics-router.target.read
Modificar um destino metrics-router.target.update
Excluir um destino metrics-router.target.delete

Gerenciamento de alvos usando a interface do usuário

Você pode gerenciar sua definição de destino usando a interface do usuário IBM Cloud Metrics Routing. Para obter mais informações, consulte Gerenciando alvos.

Pré-requisitos da CLI

Antes de usar a CLI para gerenciar destinos, conclua as seguintes etapas:

  1. Assegure-se de ter as permissões corretas do IAM para configurar o IBM Cloud Metrics Routing.

  2. Instale a CLI da IBM Cloud.

  3. Instale a CLI da IBM Cloud Metrics Routing.

Comandos de CLI

A tabela a seguir lista as ações que podem ser executadas para gerenciar destinos:

Ações-alvo
Ação Comando
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 obter mais informações, consulte IBM Cloud Metrics Routing v3 CLI.

Pré-requisitos da API

Antes de usar a API para gerenciar alvos, conclua as etapas a seguir:

  1. Assegure-se de ter as permissões corretas do IAM para configurar o IBM Cloud Metrics Routing.

  2. Obtenha um token de acesso do IAM. Para obter mais informações, consulte Recuperando tokens de acesso do iAM.

  3. Identifique o terminal da API na região em que você planeja configurar ou gerenciar um destino. Para obter mais informações, consulte Terminais.

Métodos de API

A tabela a seguir lista as ações que podem ser executadas para gerenciar destinos:

Ações de destino usando a IBM Cloud Metrics Routing API REST
Ação Método de API de 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 obter mais informações, consulte IBM Cloud Metrics Routing v3 API.

Códigos de resposta HTTP

Quando você usa a API de REST do IBM Cloud Metrics Routing, pode obter códigos de resposta HTTP padrão para indicar se um método foi concluído com sucesso.

  • A resposta 200 sempre indica sucesso.
  • A resposta 4xx indica uma falha.
  • A resposta 5xx geralmente indica um erro no sistema interno.

Consulte a tabela a seguir para obter alguns códigos de resposta HTTP:

Lista de códigos de resposta do site HTTP
Código de status Status Descrição
200 OK A solicitação foi bem-sucedida.
201 OK A solicitação foi bem-sucedida. Um recurso é criado.
204 OK O alvo foi excluído com sucesso.
400 Solicitação inválida A solicitação foi malsucedida. Um parâmetro que é necessário pode estar ausente.
401 Desautorizado A solicitação de autorização falha
403 Proibido A operação é proibida devido a permissões insuficientes.
404 Não Encontrado O recurso solicitado não existe ou já está foi excluído.
429 Muitas solicitações Muitas solicitações atingiram a API muito rapidamente.
500 Erro interno do servidor Algo deu errado no processamento do IBM Cloud Metrics Routing.