Configuração da observabilidade para frotas
O registro e o monitoramento podem ajudá-lo a solucionar problemas em IBM Cloud® Code Engine e podem fornecer informações sobre o desempenho da carga de trabalho. A configuração do registro e do monitoramento de frotas é feita no nível do projeto e é diferente de outros recursos do Code Engine.
O registro e o monitoramento são opcionais e podem ser configurados a qualquer momento após a criação de uma frota.
Configurando o registro de dados para frotas
O registro para frotas é configurado no nível do projeto. Depois de executar essas etapas de configuração para um projeto, o registro em log estará disponível para todas as frotas desse projeto.
1. Certifique-se de que você tenha uma instância de serviço do Cloud Logs existente
Você deve ter uma instância de serviço do Cloud Logs voltada para a região do projeto Code Engine em que suas frotas são executadas. Para verificar suas instâncias de serviço do Cloud Logs existentes, navegue até a página de roteamento de registro na interface do usuário e identifique a instância que tem como alvo a região relevante. Se a região não tiver uma instância de registro direcionada, siga os prompts da interface do usuário para definir uma.
2. Defina as permissões para a instância do Cloud Logs
Certifique-se de que você tenha um ID de serviço e uma chave de API que atribua acesso à instância do Cloud Logs e defina as permissões necessárias.
- Crie um ID de serviço. Em seguida, atribua ao ID do serviço uma política de acesso que tenha como alvo a instância do Cloud Logs em sua conta. Atribua a essa política de acesso o nível de acesso ao serviço Sender.
- Crie uma chave de API para a ID do serviço. Salve a chave da API em um local seguro para que possa consultá-la posteriormente.
3. Obtenha o ponto de extremidade Ingress privado para a instância do Cloud Logs
Obtenha o ponto de extremidade Ingress privado para a instância do Cloud Logs.
- Navegue até a página Instâncias de registro na interface do usuário e clique na instância relevante.
- Clique em “Endpoints ”.
- Localize o ponto de extremidade Ingress privado. Salve esse valor em um local seguro para que possa consultá-lo posteriormente.
4. Crie um gateway de ponto de extremidade privado virtual que se conecte à instância de registro
Crie um gateway de endpoint privado virtual que se conecte à instância de registro. Esse gateway VPE deve ser criado na VPC em que suas frotas são executadas.
- Navegue até a página de gateways VPE no console.
- Clique em Criar.
- Selecione o local e a região em que a instância do Cloud Logs existe.
- Selecione o VPC em que suas frotas operam.
- Conecte o serviço à sua instância do Cloud Logs.
- Na seção Solicitar conexão a um serviço, selecione a opção IBM Cloud Service.
- Em Ofertas de serviços de nuvem, selecione Logs de nuvem.
- Em Regiões de serviço de nuvem, selecione a região em que sua instância do Cloud Logs existe.
- Na tabela, selecione a instância relevante do Cloud Logs para se conectar ao VPE.
- Clique em Criar.
5. Criar endereços IP reservados no gateway VPE
Para cada zona no VPE, adicione um endereço IP reservado a uma sub-rede.
- Navegue até a página de gateways VPE no console.
- Clique no VPE que você criou na etapa anterior.
- Clique em “Gerenciar recursos anexados ”.
- Clique em “Reservar” ou “Associar IP ”.
- Siga os prompts para reservar um endereço IP para uma sub-rede em uma das zonas VPE.
- Repita esse processo para uma sub-rede em cada zona VPE.
6. Adicione os valores de registro ao segredo padrão das frotas
Adicione os valores de registro necessários ao segredo padrão das frotas.
- No console, acesse a página Code Engine projects e selecione o projeto em que suas frotas são executadas.
- Clique em “Secrets” e “configmaps ”.
- Clique no segredo
codeengine-fleet-defaults.- Se não tiver sido criado antes: clique em Create (Criar ).
- Selecione Generic secret (Segredo genérico ) e clique em Next (Avançar ).
- Dê o nome do segredo
codeengine-fleet-defaults. Você deve usar exatamente esse nome e essa formatação.
- Adicione os pares de valores-chave listados na tabela abaixo. Observe que os sites
logging_sender_api_keyelogging_ingress_endpointforam salvos em etapas anteriores.
| Chave | Valor |
|---|---|
logging_ingress_endpoint |
O ponto de extremidade de entrada privado para a instância do Cloud Logs. Esse valor foi salvo em uma etapa anterior. |
logging_sender_api_key |
A chave de API para o ID de serviço que tem como alvo a instância do Cloud Logs. Esse valor foi salvo em uma etapa anterior. |
logging_ingress_port |
A porta usada para se conectar à instância do Cloud Logs. Para VPEs privados, especifique 443. |
logging_level_worker |
O nível de detalhes que deseja incluir nos logs de trabalho. Os níveis aceitos incluem: DEBUG, INFO, WARN, e ERROR. Nível padrão: WARN. |
logging_level_agent |
O nível de detalhes que deseja incluir nos logs do agente de frota. Os níveis aceitos incluem: DEBUG, INFO, WARN, e ERROR. Nível padrão: WARN. |
7. Visualizar os registros de suas frotas
Agora que o registro está configurado para frotas no seu projeto Code Engine, você pode visualizar os registros da frota. Para obter as etapas, consulte Visualização de registros e monitoramento de dados para frotas.
Configurando o monitoramento de frotas
O monitoramento das frotas é estabelecido no nível do projeto. Depois de executar essas etapas de configuração para um projeto, o monitoramento estará disponível para todas as frotas desse projeto.
1. Certifique-se de que você tenha uma instância existente do Clouds Monitoring
Você deve ter uma instância do Cloud Monitoring na mesma região do projeto Code Engine ao qual sua frota pertence. Para verificar as instâncias de serviço existentes do Cloud Monitoring, navegue até a página Monitoring instances(Monitoramento de instâncias ) na interface do usuário e identifique uma instância na região relevante. Se você não tiver uma instância adequada, siga os prompts da interface do usuário para criar uma.
2. Obter a chave do agente de monitoramento
Encontre a chave do agente para a instância de monitoramento.
- Navegue até a página Monitoramento de instâncias na interface do usuário e clique na instância relevante. Na página de detalhes da instância, clique em Ações > Gerenciar chave e, em seguida, clique na opção para visualizar todas as chaves no painel.
- Clique na chave do agente, que pode ter um formato semelhante a
ab1c2345-****-678d9efgh012. Em seguida, clique na opção para copiar a chave completa do agente. - Salve a chave do agente em um local seguro onde possa acessá-la posteriormente.
3. Crie um gateway de ponto de extremidade privado virtual que se conecte à instância de monitoramento
Crie um gateway de endpoint privado virtual que se conecte à instância de monitoramento. Esse gateway VPE deve ser criado na VPC em que suas frotas são executadas.
- Navegue até a página de gateways VPE no console.
- Clique em Criar.
- Selecione o local e a região em que sua instância do Cloud Monitoring está localizada.
- Selecione o VPC em que suas frotas operam.
- Conecte o serviço à sua instância do Cloud Monitoring.
- Na seção Solicitar conexão a um serviço, selecione a opção IBM Cloud Service.
- Em Ofertas de serviços de nuvem, selecione Cloud Monitoring.
- Em Cloud service regions (Regiões de serviço na nuvem ), selecione a região em que sua instância Cloud Monitoring está localizada.
- Na tabela, selecione a instância relevante do Cloud Monitoring para se conectar ao VPE.
- Clique em Criar.
4. Criar endereços IP reservados no gateway VPE
Para cada zona no VPE, adicione um endereço IP reservado a uma sub-rede.
- Navegue até a página de gateways VPE no console.
- Clique no VPE que você criou na etapa anterior.
- Clique em “Gerenciar recursos anexados ”.
- Clique em “Reservar” ou “Associar IP ”.
- Siga os prompts para reservar um endereço IP para uma sub-rede em uma das zonas VPE.
- Repita esse processo para uma sub-rede em cada zona VPE.
5. Adicionar valores de monitoramento à secreta padrão das frotas
- No console, acesse a página Code Engine projects e selecione o projeto em que suas frotas são executadas.
- Clique em “Secrets” e “configmaps ”.
- Clique no segredo
codeengine-fleet-defaults.- Se não tiver sido criado antes: clique em Create (Criar ).
- Selecione Generic secret (Segredo genérico ) e clique em Next (Avançar ).
- Dê o nome do segredo
codeengine-fleet-defaults. Você deve usar exatamente esse nome e essa formatação.
- Adicione os pares de valores-chave listados na tabela abaixo. Observe que o site
monitoring_ingestion_keyfoi salvo em uma etapa anterior.
| Chave | Valor |
|---|---|
monitoring_ingestion_region |
A região em que a instância do Cloud Monitoring existe. Exemplo: au-syd. |
monitoring_ingestion_key |
A chave do agente de monitoramento. Esse valor foi encontrado em uma etapa anterior. |
6. Visualize os dados de suas frotas no painel de monitoramento
Agora que o monitoramento está configurado para as frotas em seu projeto Code Engine, você pode visualizar os dados de monitoramento da frota. Para obter as etapas, consulte Visualização de registros e monitoramento de dados para frotas.