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:
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.
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.
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:
-
Assegure-se de ter as permissões corretas do IAM para configurar o IBM Cloud Metrics Routing.
-
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çã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:
-
Assegure-se de ter as permissões corretas do IAM para configurar o IBM Cloud Metrics Routing.
-
Obtenha um token de acesso do IAM. Para obter mais informações, consulte Recuperando tokens de acesso do iAM.
-
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çã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:
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. |