Monitoramento do Satellite

IBM Cloud Satellite® oferece ferramentas integradas para monitorar o estado de locais, hosts, clusters e pontos de extremidade do Link.

O monitoramento do seu local do Satellite e dos serviços do IBM Cloud executados nesse local requer uma configuração separada. Para coletar métricas da plataforma de localização, habilite uma instância do Monitoring na mesma região que gerencia sua localização. Para coletar métricas do Pod de um cluster do Red Hat OpenShift on IBM Cloud em sua instância do Satellite, implante um agente de monitoramento no cluster para encaminhar as métricas para uma instância do Monitoring. Uma única instância do Monitoring coleta métricas tanto para o seu local do Satellite quanto para os serviços em execução nele.

Entendendo o que é registrado e monitorado por padrão

Por padrão, o Satellite gera determinados eventos de atividade e monitora o estado do seu local e recursos de host.

Auditando eventos para ações do Satellite

Consulte Auditando eventos do Satellite.

IBM Monitoring para resolver e relatar alertas de localização

IBM monitora e resolve automaticamente condições de alerta específicas relacionadas à configuração do seu local e à infraestrutura de servidores. A tabela a seguir apresenta cada cenário e a ação tomada.

Além disso, se você configurar sua instância do Satellite para encaminhar os registros para IBM Cloud Logs, as mensagens e informações mais detalhadas do componente de monitoramento do IBM serão capturadas e armazenadas em sua instância do IBM Cloud Logs.

Ações de monitoramento da IBM para tratar determinados cenários.
Cenário	Ação
O plano de controle de localização não tem um host em três zonas separadas.	Verifique os hosts anexados e não designados na localização. Se um host estiver disponível, designe o host ao plano de controle de localização para a zona ausente, dando preferência aos hosts com um rótulo que corresponda à zona.
A capacidade do cluster excede 80% em uma zona.	Impeça ou permita que os clusters Red Hat OpenShift sejam criados. Designe os hosts disponíveis a um plano de controle de localização para obter mais recursos de cálculo.
Os clusters Red Hat OpenShift estão em um estado não funcional.	Resolva determinados problemas de funcionamento com os clusters Red Hat OpenShift.
Ferramentas de monitoramento padrão, como o Prometheus, não funcionam.	Envie alertas para a sua instância do IBM Cloud Logs e retorne uma mensagem de status com informações adicionais de resolução de problemas.
O registro de subdomínio do Ingress falha.	Alerte os engenheiros da IBM para analisarem mais os problemas e retornarem uma mensagem de status com mais informações sobre a resolução de problemas.

Visualizando o funcionamento da localização, do host e do cluster

Verifique o estado dos recursos do Satellite, incluindo locais, hosts, clusters e recursos do Kubernetes.

Visualizando o funcionamento da localização

IBM Cloud monitora os servidores que hospedam o site Satellite e informa o status deles. Consulte “IBM: monitoramento de alertas e depuração do estado da localização ”.

Você pode verificar o estado de integridade do host na tabela “ Locais ” em Satellite console ou executando o comando ibmcloud sat location ls.

Estados de funcionamento do local
Estado de funcionamento	Descrição
`action required`	A localização precisa de sua atenção. Verifique o status e a mensagem para obter mais informações e tente depurar sua localização.
`completed`	O Satellite concluiu a configuração dos componentes do plano de controle de localização nos hosts que você designou ao plano de controle. A localização estará logo pronta para ser usada.
`completing`	O Satellite está configurando os componentes do plano de controle de localização nos hosts que você designou ao plano de controle. Verifique novamente daqui a pouco.
`critical`	O plano de controle de localização do Satellite precisa de sua atenção. Verifique o status e a mensagem para obter mais informações e tente depurar seu plano de controle de localização.
`failed`	O Satellite não resolveu com sucesso os problemas em sua localização. Para obter mais informações, consulte a mensagem de status.
`host required`	A localização do Satellite é criada, mas deve-se designar hosts ao plano de controle de localização. Designe hosts em múltiplos de três, como seis, nove ou doze.
`normal`	A localização do Satellite está pronta para uso.
`provisioning`	O plano de controle para o Satellite está sendo provisionado. Não é possível designar hosts a outros recursos do Satellite, como clusters, na localização até que o plano de controle esteja pronto.
`resolving`	O Satellite está tentando resolver problemas para você, por exemplo, designando hosts disponíveis ao plano de controle para aliviar problemas de capacidade. Para obter mais informações, consulte a mensagem de status.

Visualizando o funcionamento do host

Ao anexar hosts a uma localização do Satellite, a IBM Cloud monitora o host e relata de volta os status que podem ser usados para manter seus hosts funcionais. Para mais informações, consulte IBM Monitoring para resolver e relatar alertas de localização. Para ajuda de resolução de problemas, consulte Depurando o funcionamento do host.

Você pode verificar o estado de integridade do host na tabela “Hosts” do console do Satellite ou executando ibmcloud sat host ls --location <location_name_or_ID>.

Estados de funcionamento do host.
Estado de funcionamento	Descrição
`assigned`	O host é designado a um recurso do Satellite, como um plano de controle de localização ou cluster. Visualize o status para obter mais informações. Se o status for `-`, os hosts não concluíram o processo de autoinicialização para o recurso do Satellite. Para os hosts recém-designados, espere aproximadamente uma hora para que o processo seja concluído. Se você ainda vir o status, efetue login no host para continuar a depuração.
`health-pending`	O host é designado e autoinicializado no cluster como nós do trabalhador que são provisionados e implementados. No entanto, os componentes de funcionamento que a IBM configura no host não podem comunicar o status de volta à IBM Cloud. Certifique-se de que seus hosts atendam aos requisitos mínimos de conectividade de host e de rede e que os hosts não estejam bloqueados por um firewall em seu provedor de infraestrutura.
`provisioning`	O host é anexado à localização do Satellite e está no processo de autoinicialização para se tornar parte de um recurso do Satellite, como o nó do trabalhador de um cluster Red Hat OpenShift on IBM Cloud. Enquanto o host relata um estado `provisioning`, o nó do trabalhador passa pelos estados de fornecimento e implementação. É possível efetuar login no host enquanto nesse estado para visualizar logs. Consulte Ativação do SSH em hosts Satellite.
`ready`	O host é anexado à localização do Satellite e está pronto para ser designado a um recurso do Satellite.
`normal`	O host é designado a um recurso do Satellite, como um plano de controle de localização ou cluster, e está pronto para uso.
`reload-required`	O host é anexado à localização do Satellite, mas requer um recarregamento antes que ele possa ser designado a um recurso do Satellite. Por exemplo, se você excluiu um cluster do Satellite, todos os hosts desse cluster precisam ser recarregados. Para recarregar um host, deve-se remover o host do local, recarregar o sistema operacional no provedor de infraestrutura subjacente e anexar o host de volta ao local.
`unassigned`	O host é anexado à localização do Satellite e está pronto para ser designado a um recurso do Satellite. Se você tentou designar o host sem sucesso, consulte Não é possível designar hosts a um cluster.
`unknown`	O funcionamento do host é desconhecido. Se o host não estiver designado, tente designá-lo a um recurso do Satellite, como um cluster. Se o host for atribuído, tente depurar o host seguindo as etapas em Depurando o funcionamento do host. Se o host ainda tiver problemas, tente remover, atualizar e reconectar o host.
`unresponsive`	Não foi efetuado check-in do host com o plano de controle de local do Satellite dentro dos últimos 5 minutos. O host não poderá ser designado quando ele não for responsivo. Tente depurar o funcionamento do host, particularmente a conectividade de rede.

Ao visualizar a tabela “Hosts” no console do Satellite, os hosts do plano de controle que requerem atenção exibem rótulos de status atualizados. A etiqueta “Ação necessária” (anteriormente “Aviso” ) indica que o host precisa da sua atenção. A etiqueta “Substituição necessária” indica que o host está significativamente desatualizado e deve ser substituído. Ambos os status exibem uma dica de ferramenta com um link para o procedimento de atualização do host. Para obter mais informações, consulte “Identificação de hosts do plano de controle que precisam ser atualizados ”.

Visualizando o funcionamento do cluster

Consulte a documentação do Red Hat OpenShift on IBM Cloud para verificar o estado do cluster no seu endereço Satellite.

Visualizando recursos do Kubernetes em clusters

Os clusters adicionados à configuração do Satellite têm seus recursos do Kubernetes automaticamente incluídos no inventário para análise.

A inclusão de clusters na Configuração do Satellite não configura automaticamente as soluções de criação de log e monitoramento, como o IBM Cloud Logs e o IBM Cloud Monitoring.

Visualizando status de registro do Satellite Config para clusters

Visualize o status de registro dos clusters habilitados para a configuração do Satellite, incluindo aqueles em locais de nuvem pública.

Liste clusters que são registrados com o Satellite Config. Observe a saída nas colunas Status e Local.
```
ibmcloud sat cluster ls
```
Revise os seguintes status de registro de Satellite Config.

Estados de funcionamento do host.
Status	Descrição
`active`	Os componentes do Satellite Config para o local são instalados no cluster e pelo menos um recurso está sendo inspecionado.
`inactive`	Os componentes do Satellite Config foram removidos manualmente do cluster ou estão instalados, mas não estão mais respondendo ao Satellite Config. Por exemplo, a conexão de rede está desativada. Os recursos existentes, se houver, continuam sendo executados, mas não recebem atualizações. Para resolver o problema, tente depurar o local do Satellite ou o cluster.
`registered`	Os componentes do Satellite Config estão instalados no cluster, mas nenhum recurso está sendo inspecionado atualmente. Para configurar o Watch-keeper, consulte Revendo recursos que são gerenciados por Satellite Config.

Configurando o Monitoring para métricas de plataforma de local do Satellite

Encaminhe e visualize as métricas do Satellite em uma instância do IBM Cloud Monitoring habilitada para métricas no nível da plataforma.

As métricas estão disponíveis para o componente Satellite Link de sua localização para ajudá-lo a monitorar o desempenho de terminais específicos do Link ou de todos os terminais do Link para a localização. Por exemplo, é possível monitorar a latência ou o rendimento de um terminal específico do Link que você criou.

Crie ou escolha uma instância existente do Monitoring.
- Se você já tiver uma instância do Monitoring na mesma região da IBM Cloud por meio da qual o local do Satellite é gerenciado e a instância do Monitoring estiver configurada para coletar métricas de plataforma, as métricas geradas para o local do Satellite serão encaminhadas automaticamente para esta instância do Monitoring.
- Caso contrário, para configurar o Monitoring para o local do Satellite:
  1. Providencie uma instância do IBM Cloud Monitoring na mesma região do IBM Cloud a partir da qual sua localização do Satellite é gerenciada.
  2. Ative a instância para a coleta de métricas de nível de plataforma. Dentro de uma região, apenas uma instância do Monitoring está habilitada para a coleta de métricas da plataforma por vez.
No painel Monitoramento, clique em Abrir painel para a instância do Monitoring.
No painel do Monitoring, clique em Painéis > IBM > Satellite Link- Visão geral. O painel predefinido para as métricas do Satellite Link é aberto. As instâncias recém-criadas do Monitoring levam até duas horas para que os IBM painéis fiquem disponíveis.

É possível criar uma cópia desse painel para customizar as métricas que são mostradas. Para incluir as métricas que estão ativadas para o IBM Cloud Satellite, procure o prefixo ibm_satellite_link.
Revise as métricas disponíveis e os atributos para segmentação.
Revise mais maneiras pelas quais é possível trabalhar com métricas da plataforma.

Depois de configurar o Monitoring com o painel predefinido para métricas do Satellite Link, é possível acessar rapidamente esse painel por meio da guia Terminais de Link do console do local do Satellite clicando em Ativar monitoramento.

Métricas disponíveis

As seguintes métricas estão disponíveis para o plano de controle da sua instância do Satellite.

Números de túneis de localização

O número total de servidores de túnel do Satellite Link presentes no terminal. São criados três túneis entre o servidor do túnel e o conector para suportar a redundância nas três zonas de disponibilidade de seu local.

Metadados para a métrica de números do túnel de localização
Metadados	Descrição
`Metric Name`	`ibm_satellite_link_location_tunnel_count`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID`

Latência de localização

O tempo total de ida e volta (RTT) dos dados, em milissegundos, para essa localização. O RTT mede o tempo que um pacote de dados leva para viajar do local até IBM Cloud e voltar.

Metadados para a métrica de latência de localização
Metadados	Descrição
`Metric Name`	`ibm_satellite_link_location_rtt_second`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID`

Tráfego de localização para a nuvem

A taxa total de dados em bytes por segundo na direção para-nuvem para a localização.

Metadados para o tráfego de localização para a métrica em nuvem
Metadados	Descrição
`Metric Name`	`ibm_satellite_link_location_to_cloud_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID`

Tráfego de localização da nuvem

A taxa total de dados em bytes por segundo na direção da-nuvem para a localização.

Metadados para o tráfego de localização a partir da métrica em nuvem
Metadados	Descrição
`Metric Name`	`ibm_satellite_link_location_from_cloud_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID`

Total de tráfego de localização

A taxa total de dados em bytes por segundo nas direções para-nuvem e da-nuvem para a localização.

Metadados para a métrica total do tráfego de localização
Metadados	Descrição
`Metric Name`	`ibm_satellite_link_location_total_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID`

Contagem de conexões de terminal

O número total de conexões presentes no terminal.

Metadados para a métrica de contagem de conexões do Endpoint
Metadados	Descrição
`Metric Name`	`ibm_satellite_link_endpoint_connection_count`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID, Endpoint ID, Endpoint Name`

Tráfego de terminal para a nuvem

A taxa de dados em bytes por segundo na direção para-nuvem para o terminal.

Metadados para o tráfego de Endpoint para a métrica em nuvem
Metadados	Descrição
`Metric Name`	`ibm_satellite_link_endpoint_to_cloud_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID, Endpoint ID, Endpoint Name`

Tráfego de terminal da nuvem

A taxa de dados em bytes por segundo na direção da-nuvem para o terminal.

Metadados para o tráfego de terminais a partir da métrica em nuvem
Metadados	Descrição
`Metric Name`	`ibm_satellite_link_endpoint_from_cloud_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID, Endpoint ID, Endpoint Name`

Total de tráfego de terminal

A taxa total de dados em bytes por segundo nas direções para-nuvem e da-nuvem para o terminal.

Metadados para a métrica total do tráfego de terminais
Metadados	Descrição
`Metric Name`	`ibm_satellite_link_endpoint_total_data_rate`
`Metric Type`	`gauge`
`Value Type`	`none`
`Segment By`	`Service instance, Service instance name, Location ID, Endpoint ID, Endpoint Name`

Atributos para segmentação

Revise os atributos globais e adicionais a seguir que estão disponíveis para segmentação de métricas do Satellite.

Atributos globais

Os atributos globais a seguir estão disponíveis para segmentar todas as métricas disponíveis.

Atributos globais para segmentação de métrica
Atributo	Nome do atributo	Descrição do atributo
`Cloud Type`	`ibm_ctype`	O tipo de nuvem, que pode ser público, dedicado ou local
`Location`	`ibm_location`	A localização do recurso monitorado, que pode ser uma região, data center ou global
`Resource`	`ibm_resource`	O recurso que é medido pelo serviço, geralmente relatado como um nome de identificação ou GUID
`Resource Type`	`ibm_resource_type`	O tipo do recurso que é medido pelo serviço
`Resource group`	`ibm_resource_group_name`	O grupo de recursos no qual a localização do Satellite foi criada
`Scope`	`ibm_scope`	O GUID da conta associado a essa métrica
`Service name`	`ibm_service_name`	O nome do serviço que gera essa métrica

Atributos adicionais

Os atributos adicionais a seguir específicos para o Satellite estão disponíveis para segmentar uma ou mais das métricas disponíveis. Consulte o campo Segment By para cada métrica para determinar seus atributos de segmentação disponíveis.

Atributos adicionais para segmentação de métrica
Atributo	Nome do atributo	Descrição do atributo
`Endpoint ID`	`ibm_satellite_link_endpoint_id`	O identificador do terminal
`Endpoint Name`	`ibm_satellite_link_endpoint_name`	O nome do terminal
`Location ID`	`ibm_satellite_link_location_id`	O identificador da localização
`Service instance`	`ibm_service_instance`	O segmento de instância de serviço identifica a instância à qual a métrica está associada
`Service instance name`	`ibm_service_instance_name`	O nome da instância do serviço fornecido pelo usuário. Não é garantido que os nomes das instâncias de serviço sejam exclusivos entre as regiões da conta.

Configurando o monitoramento para clusters

No momento, não é possível usar o console do Red Hat OpenShift on IBM Cloud para habilitar o monitoramento de clusters do Satellite. Deve-se implementar manualmente agentes de monitoramento ao seu cluster para encaminhar métricas para o Monitoring.

Para configurar o monitoramento para clusters do Red Hat OpenShift que são executados em seu local do Satellite, consulte Implementando um agente de monitoramento em um cluster do Red Hat OpenShift. Ao especificar o endereço para o COLLECTOR_ENDPOINT, é possível usar o endereço do terminal do link satellite-sysdig para que não seja necessário abrir novas regras de firewall.