Antes de Iniciar

1. Se você não tiver uma conta IBM Cloud, registre uma conta IBM Cloud. É necessário um IBMid para trabalhar no IBM Cloud.

2. 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.

   Para obter mais informações, consulte Saiba mais sobre IBM Cloud Logs Routing.

3. Verifique as regiões nas quais o serviço IBM Cloud Logs Routing está disponível. Identifique uma região em que você opera em IBM Cloud e verifique se ela está na lista de regiões compatíveis.

4. Verifique se o usuário que está configurando IBM Cloud Logs Routing para a conta IBM Cloud® tem permissões suficientes para gerenciar o serviço IBM Cloud Logs Routing. Para obter mais informações, consulte Gerenciando o acesso IAM para IBM Cloud Logs Routing.

   Você precisa da função de serviço reader para visualizar locatários e alvos.

   Você precisa da função de serviço manager para criar, excluir, atualizar locatários e destinos.

5. Instale as seguintes ferramentas:

   • Faça download e instale o IBM Cloud® CLI.

   • Provisiona uma instância do IBM Cloud Logs. Para obter mais informações, consulte Provisionando uma instância.

   • Baixe e instale o jq para processar a saída e consultar os resultados desejados.

Criação de uma autorização de serviço para serviço

Você deve usar o IBM Cloud® Identity and Access Management (IAM) para criar uma autorização que conceda IBM Cloud Logs Routing acesso ao IBM Cloud Logs para que o serviço IBM Cloud Logs Routing possa enviar logs para o destino (target) da sua instância IBM Cloud Logs.

Você deve ter a função de remetente para IBM Cloud Logs antes de configurar o serviço para autorização de serviço.

Conclua as etapas a seguir:

1. No console do IBM Cloud, clique em Gerenciar > Acesso (IAM) e selecione Autorizações.

2. Clique em Criar.

3. Configure a conta de origem. Selecione Esta conta.

4. Selecione Roteamento de logs como o serviço de origem. Em seguida, defina o escopo do acesso como Todos os recursos.

5. Selecione Cloud Logs como o serviço de destino. Em seguida, defina o escopo do acesso como Todos os recursos, o que concede acesso a todas as IBM Cloud Logs instâncias ou a uma única instância configurando Recursos com base em atributos selecionados > Instância de serviço.

   Outros atributos não são compatíveis com esse tipo de autorização.

6. Na seção Service Access, selecione Sender para atribuir acesso ao serviço de origem que acessa o serviço de destino.

7. Clique em Autorizar.

Para obter mais informações, consulte Criando uma autorização S2S para conceder acesso ao envio de registros para IBM Cloud Logs.

Criação de um locatário

Quando o console IBM Cloud Logs Routing é exibido pela primeira vez, todas as informações de destino existentes são exibidas.

Se nenhum destino estiver configurado para uma região, a região exibirá a opção Definir destino.

No console IBM Cloud Logs Routing, você pode criar um locatário e um destino de destino configurando a opção Definir destino para a região que deseja configurar.

Conclua as etapas a seguir:

1. Faça login em sua IBM Cloud conta.

2. Clique no ícone de menu Ícone > Observability (Observabilidade ).

3. Clique em Logging > Routing.

4. Clique em Set target.

5. Clique na guia Cloud Logs e selecione uma instância IBM Cloud Logs na lista. Essa é a instância em que você deseja receber os logs que são roteados por IBM Cloud Logs Routing.

   Você pode selecionar uma instância do site IBM Cloud Logs na lista.

   A instância IBM Cloud Logs deve estar localizada na mesma conta que você está configurando.

6. Clique em Salvar.

Verificação de que os registros são enviados ao destino de destino

Verifique se os logs do seu cluster são roteados para a instância IBM Cloud Logs.

Todos os logs da plataforma são gerados em JSON. Você pode filtrar os logs de plataforma na sua instância selecionando o valor de ibm-platform-logs como applicationName.

Conclua as etapas a seguir:

1. Inicie a IBM Cloud Logs interface de usuário da Web para a instância IBM Cloud Logs que está configurada como o destino para coletar logs de plataforma em uma região. Essa é a instância que você selecionou na etapa em que configurou um destino.
2. Visualize os registros por meio de exibições personalizadas. Para obter mais informações, consulte Visualizando logs .