IBM Cloud Docs
Criação de log para o Satellite

Criação de log para o Satellite

Integre o Satellite e outros recursos da IBM Cloud ao IBM® Cloud Logs para obter uma visão abrangente e ferramentas para gerenciar todos os seus recursos.

A criação de log para a sua localização do Satellite e para os serviços da IBM Cloud que são executados em sua localização deve ser configurada separadamente. Por exemplo, para coletar logs para a configuração do local Satellite, habilite uma instância IBM Cloud Logs para coletar logs da plataforma na mesma região em que o local é gerenciado. Em seguida, para coletar logs para um cluster Red Hat OpenShift on IBM Cloud que é executado no local Satellite, você cria um agente de registro no cluster para coletar e encaminhar automaticamente os logs do pod para uma instância IBM Cloud Logs. Observe que é possível usar a mesma instância do IBM Cloud Logs para coletar logs para o local do Satellite e serviços que são executados no local do Satellite.

Configurando o IBM Cloud Logs para logs da plataforma de local do Satellite

Encaminhe e visualize os logs que são gerados automaticamente para a sua configuração de localização do Satellite em uma instância do IBM Cloud Logs ativada para logs de nível de plataforma.

Ativando logs da plataforma

Se já houver uma instância IBM Cloud Logs na mesma região IBM Cloud da qual o local Satellite é gerenciado e a instância IBM Cloud Logs estiver configurada para coletar logs da plataforma, os logs gerados para o local Satellite serão automaticamente encaminhados para essa instância IBM Cloud Logs. Caso contrário, siga estas etapas para configurar o IBM Cloud Logs para o local do Satellite.

  1. Provisione uma instância IBM Cloud Logs na mesma região IBM Cloud da qual seu local Satellite é gerenciado.
  2. Ative a instância para a coleção de logs de nível de plataforma. Observe que dentro de uma região, somente uma instância do IBM Cloud Logs pode ser ativada para a coleção de logs da plataforma.

Visualizando logs para o local do Satellite

Como a instância do IBM Cloud Logs está ativada para a coleta de logs de nível de plataforma, os logs para todos os serviços integrados do IBM Cloud Logs são mostrados no painel do IBM Cloud Logs. É possível aplicar filtros para visualizar apenas logs para o seu local do Satellite.

  1. No painel Logging, clique em Open Dashboard (Abrir painel) para sua instância IBM Cloud Logs.
  2. Na barra de ferramentas Filtros, clique em Origens, selecione satellite e clique em Aplicar. Os logs para todos os seus locais do Satellite na região são mostrados.
  3. Para filtrar por um local específico do Satellite, clique em Apps na barra de ferramentas Filtros, selecione o CRN para o local do Satellite e clique em Aplicar. Para identificar o CRN para o seu local, obtenha o ID do local executando ibmcloud sat location ls, procure o ID desse local no final dos CRNs listados.

Para obter mais dicas sobre como identificar logs no painel, revise como é possível procurar e filtrar logs.

Analisando logs para o local do Satellite

Use os logs que são gerados automaticamente para o local do Satellite para monitorar e manter o seu funcionamento.

Com que frequência os logs são postados?

Os logs são coletados para o seu local e postados a cada 60 segundos.

Quais tipos de logs são coletados?

Por padrão, três tipos de logs são gerados automaticamente para o local do Satellite: mensagens de erro de nível R00XX, o status se a implementação de recursos no local está ativada e o status do Satellite Link. Revise as seções a seguir para um exemplo de cada tipo de log e as descrições de cada campo de log.

Como configurar alertas para logs de erro de local?

É possível usar as ferramentas de painel integradas do IBM Cloud Logs para salvar procuras de log e configurar alertas para alguns tipos de logs, como erros.

  1. Para filtrar por um local específico do Satellite, clique em Apps na barra de ferramentas Filtros, selecione o CRN para o local do Satellite e clique em Aplicar. Para identificar o CRN para o seu local, procure o ID do local no final do CRN.
  2. Procure uma consulta específica para a qual você deseja um alerta. Por exemplo, para ser alertado de quaisquer logs que contenham mensagens de erro de local de nível R00XX, procure por R00. Para ser alertado de falhas de verificação de funcionamento do Satellite Link, procure por Failed to reach endpoint.
  3. Clique em Visualização não salva > Salvar como uma nova visualização. Inclua um nome e uma categoria opcional.
  4. Na lista suspensa Alerta, selecione Alerta específico da visualização e siga as etapas para o canal de notificação selecionado para configurar um alerta customizado para essa consulta de log.
  5. Clique em Salvar visualização.

O IBM é alertado para qualquer um desses logs?

O componente IBM Cloud Monitoring gera determinados alertas para problemas com sua configuração de localização e infraestrutura de host. Para revisar os alertas que a IBM monitora, consulte o Monitoramento da IBM para resolver e relatar alertas de localização.

logs de erroR00XX

Mensagens de relatório de logs de erro R00XX e informações mais detalhadas sobre problemas com a configuração de local e a infraestrutura de host. Para obter mais informações sobre cada mensagem de erro R00XX, incluindo etapas de resolução de problemas, consulte Mensagens de erro de local.

Log de exemplo

{"logSourceCRN":"crn:v1:bluemix:public:satellite:us-south:a/f601ad712b0dd981276cf3b995554afc:c1hk4ek107l5au5mq8hg::","saveServiceCopy":true,"Details":{"message":"R0025: The Satellite location has OpenShift clusters in critical health.","errorDetails":"Customer etcd cluster moved down to 1 or less available pods. Quorum broke. Manual recovery of cluster needed.","messageID":"R0025"}}
Campos predefinidos para logs de erro R00XX
Campo de log Descrição
logSourceCRN O CRN do local do Satellite. Para identificar o CRN para um local, procure o ID do local no final do CRN.
saveServiceCopy Configure como true para que uma cópia do registro de log seja enviada para a IBM para monitoramento e alertas.
Details As informações detalhadas para o log.
Details.message A mensagem de erro atual para o local, incluindo quaisquer etapas de resolução de problemas ou links de documentação.
Details.errorDetails Outros detalhes para o erro atual, como causas ou problemas específicos com determinados componentes. Esses detalhes são usados por engenheiros de confiabilidade de site da IBM para gerenciar alertas, mas podem ajudar a fornecer mais detalhes sobre o problema enquanto você os soluciona.
Details.messageID O identificador R00XX da mensagem de erro.

Ativação de logs de implementação de recursos

A ativação de logs de implementação de recurso relata o status atual que indica se recursos, como hosts, clusters ou instâncias de serviço IBM Cloud ativadas para o Satellite, podem ser mudados ou implementados em seu local e a razão para esse status. Por exemplo, a implementação de recursos pode ser configurada como false devido a um ou mais erros de local.

Log de exemplo

{"logSourceCRN":"crn:v1:bluemix:public:satellite:us-south:a/f601ad712b0dd981276cf3b995554afc:c1hk4ek107l5au5mq8hg::","saveServiceCopy":true,"message":"Enablement of resource deployment in the location is set false due to R0012: The location control plane does not have hosts in all 3 zones. Add available hosts to your location for the control plane. R0025: The Satellite location has OpenShift clusters in critical health."}
Campos predefinidos de logs para o status de ativação de implementação
Campo de log Descrição
logSourceCRN O CRN do local do Satellite. Para identificar o CRN para um local, procure o ID do local no final do CRN.
saveServiceCopy Configure como true para que uma cópia do registro de log seja enviada para a IBM para monitoramento e alertas.
message O status se a implementação de recursos está ativada atualmente (true ou false). Se configurado como false, as mensagens atuais de erro de nível R00XX para o local serão listadas.

Configurando o IBM Cloud Logs para eventos do local do Satellite

Para rastrear como os usuários e os aplicativos interagem com seu local do Satellite, o IBM Cloud Satellite gera automaticamente eventos de gerenciamento iniciados pelo usuário e encaminha esses logs de eventos para o IBM Cloud Logs.

Para acessar esses registros, provisione uma instância de IBM Cloud Logs na mesma região em que seu local é gerenciado. Para obter mais informações sobre os tipos de eventos do Satellite que podem ser rastreados, consulteAuditando eventos para o Satellite.

Configurando a criação de log para clusters

Para entender e configurar a criação de log para clusters Red Hat OpenShift que são executados no local do Satellite, consulte os tutoriais na Documentação do IBM Cloud Logs.

No momento, não é possível usar o console Red Hat OpenShift on IBM Cloud para ativar o registro em log para clusters Satellite. Você deve implantar manualmente agentes de registro em seu cluster para encaminhar os registros para IBM Cloud Logs.

Ativando uma instância de criação de log em seu cluster

Para ativar uma instância de criação de log em seu cluster Satellite , deve-se instalar manualmente o agente de criação de log no cluster.

  1. Localize uma instância de registro existente que deseja instalar em seu cluster. A instância de criação de log deve estar na mesma região da qual o local do Satellite do seu cluster é gerenciado.

  2. Na página Registro, clique na instância de registro.

  3. Clique em Fontes de registro e navegue até a guia Red Hat OpenShift guia.

  4. Siga as instruções na guia Red Hat OpenShift para instalar o agente de criação de log. A etapa 5 Instalar o OpenShift DaemonSet menciona arquivos YAML para Terminal Público e Terminal Privado. É possível editar manualmente esses arquivos YAML (agent-resources-openshift.yaml e agent-resources-openshift-private.yaml) para usar o endereço do terminal de link do satellite-logdna para que não seja necessário abrir novas regras de firewall.