Aprendendo sobre IBM Cloud Logs Routing
Você pode usar o serviço IBM Cloud Logs Routing para rotear os logs da plataforma gerados por instâncias selecionadas do serviço IBM Cloud para o destino escolhido (target).
Para obter mais informações, consulte Sobre os registros da plataforma.
Para configurar os logs da plataforma, você deve configurar locatários e destinos (destinations) na sua conta IBM Cloud.
Um locatário é a configuração específica da conta de IBM Cloud Logs Routing em execução em uma região. Você pode definir até um destino de destino por locatário e por região. O destino define para onde os logs são encaminhados.
Locatários
Ao gerenciar locatários, considere as seguintes informações:
-
Você deve criar um locatário na sua conta em cada região em que deseja usar IBM Cloud Logs Routing para coletar e rotear logs de plataforma.
Cada região é independente.
As regiões não compartilham dados.
-
Ao criar um locatário, você deve definir 1 destino de destino. Para obter mais informações, consulte Criando um locatário.
-
Quando você atualiza um locatário, só pode modificar o nome do locatário.
-
Ao excluir um locatário, você também exclui as definições de destino. Se quiser excluir uma instância de destino de destino, você deverá excluir a instância separadamente.
-
Você pode listar todos os locatários em uma conta usando o método da API
GET /tenants. -
Para obter os detalhes sobre um locatário, você pode usar o método da API
GET /tenants/{tenant_id}especificando o ID do locatário retornado ao listar os locatários em uma conta.
Você também pode ver os locatários configurados e os destinos de destino usando a interface de configuração de roteamento.
Destinos
IBM Cloud Logs Routing suporta alvos de instâncias IBM Cloud Logs.
Somente os pontos de extremidade de entrada públicos têm suporte ao configurar um destino para uma instância de IBM Cloud Logs.
Para obter mais informações, consulte Configurando o serviço IBM Cloud Logs Routing para rotear os registros da plataforma para uma instância IBM Cloud Logs.
A instância de destino IBM Cloud Logs Routing pode estar localizada na mesma conta, em uma conta diferente e na mesma região ou em uma região diferente do locatário IBM Cloud Logs Routing.
Ao gerenciar metas, considere as seguintes informações:
-
Você pode atualizar os detalhes da configuração do destino, como host de destino, porta de destino, nome do destino, CRN da instância de destino e muito mais.
-
Você pode listar todos os alvos em um locatário usando o método da API
GET /tenants/{tenant_id}/targets. -
Para obter os detalhes sobre um alvo usando o método da API
GET /tenants/{tenant_id}/targets/{target_id}.
Você também pode ver os locatários configurados e os destinos de destino usando a interface de configuração de roteamento.
A autorização entre o serviço IBM Cloud Logs Routing e as instâncias de destino de destino é feita por meio do IAM.
Conectando-se ao IBM Cloud Logs Routing
IBM® Cloud Logs Routing fornece pontos de extremidade de API para funções de gerenciamento, como criar ou gerenciar uma configuração de locatário. Esses pontos de extremidade da API são acessados por meio de URLs específicos da região. Você pode encontrar os pontos de extremidade para cada região compatível aqui.
Você pode gerenciar IBM Cloud Logs Routing usando a API de gerenciamento. A API de gerenciamento é compatível com um ponto de extremidade público ou um ponto de extremidade privado. Um ponto de extremidade público pode ser acessado pela Internet, enquanto um ponto de extremidade privado pode ser acessado somente de dentro da rede privada.
Por meio da interface do usuário IBM Cloud Logs Routing, você pode criar um locatário em uma região usando a rede pública.
O IBM® Cloud Logs Routing é compatível com os seguintes tipos de pontos de extremidade para se conectar de forma privada ao IBM Cloud Logs Routing:
- IBM Cloud Ponto de extremidade do serviço de nuvem (CSE)
- Virtual Private Endpoint (VPE) for VPC.
Se você estiver se conectando a partir de um IBM Cloud VPC, poderá se conectar usando um CSE ou VPE for VPC. Para obter mais informações, consulte Usando terminais privados virtuais para VPC para conectar-se privadamente ao IBM Cloud Logs Routing.
Se estiver se conectando de um sistema que não está contido em um IBM Cloud VPC, sua única opção de endpoint privado é conectar-se usando um CSE. Conectar-se ao IBM Cloud Logs Routing usando um CSE pode não exigir nenhum trabalho adicional de sua parte. O acesso aos CSEs só está disponível na rede privada do IBM Cloud. Para obter mais informações, consulte Usando terminais de serviço para conectar-se privadamente ao IBM Cloud Logs Routing.
Você só pode acessar a interface do usuário IBM Cloud Logs Routing por meio da rede pública.
Você pode gerenciar IBM Cloud Logs Routing usando a API de gerenciamento. A API de gerenciamento é compatível com um ponto de extremidade público ou um ponto de extremidade privado. Um ponto de extremidade público pode ser acessado pela Internet, enquanto um ponto de extremidade privado pode ser acessado somente de dentro da rede privada.
- Para criar, atualizar ou excluir uma configuração, você pode usar a API de gerenciamento IBM Cloud Logs Routing ou a interface do usuário IBM Cloud Logs Routing.
- Para ver a lista de endpoints de gerenciamento, consulte Endpoints.
O uso do endpoint público não requer trabalho adicional.