Criando painéis customizados para monitorar o Code Engine

Use IBM Cloud Monitoring para obter visibilidade do funcionamento e desempenho de cargas de trabalho do Code Engine. É possível customizar um painel do Monitoring para as cargas de trabalho do Code Engine para um conjunto customizado de métricas para ajudá-lo a identificar gargalos ou prever possíveis problemas de produção.

Criar painéis customizados para monitorar o Code Engine

É possível criar um painel do Monitoring customizado para as cargas de trabalho do Code Engine para um conjunto customizado de métricas.

Antes de criar um painel customizado no Monitoring, deve-se primeiro configurar o monitoramento para as cargas de trabalho do Code Engine. Configure sua instância de serviço do Monitoring e ative o Platform Metrics na mesma região dos projetos Code Engine que você deseja monitorar. Se você tiver implementações em mais de uma região, o Monitoring deverá ser provisionado e as métricas de plataforma ativadas para cada região. Para obter mais informações sobre como configurar sua instância de serviço do IBM Cloud Monitoring e acessar seu painel de métricas do IBM Cloud Monitoring para monitoramento de cargas de trabalho do Code Engine, consulte Monitoramento para Code Engine.

O Code Engine fornece o painel IBM Code Engine Project Overview, que é composto de painéis pré-definidos que monitoram vários aspectos de cargas de trabalho do Code Engine. Talvez você queria criar um painel do Monitoring customizado para cargas de trabalho do Code Engine para um conjunto customizado de métricas.

  1. Configure uma IBM Cloud Monitoring instância de serviço . Para verificar se há instâncias ativas do IBM Cloud Monitoring, consulte o Painel de visibilidade.

  2. Certifique-se de que há dados de monitoramento disponíveis. Como projetar um painel customizado é mais fácil quando você tem dados para monitorar, é importante ter um aplicativo ou tarefa em execução. Algumas métricas do Code Engine existirão apenas se elas estiverem disponíveis no ambiente.

  3. Revise as métricas disponíveis para Code Engine.

  4. Acesse suas métricas do IBM Cloud Monitoring.

    1. No menu de navegação do IBM Cloud, selecione Visibilidade.
    2. Selecione Monitorando.
    3. Clique em “Painel” na coluna “Exibir” da sua instância de monitoramento para abrir o painel dessa instância.
    4. No menu de navegação, selecione Painéis->IBM->Visão geral de projeto IBM Code Engine. Se você não encontrar o painel “ Code Engine ” no menu, poderá iniciar o monitoramento a partir do seu aplicativo ou tarefa do Code Engine selecionando “Adicionar monitoramento ”.

  5. Clique em “Copiar para meus painéis ” para criar uma cópia do painel “ IBM Code Engine Project Overview ”. Digite um nome para o seu painel customizado e clique em Criar e abrir. Por exemplo, nomeia seu painel My custom IBM Code Engine Project Overview.

  6. Customize seu painel incluindo ou removendo painéis. Para exemplos de como é possível querer customizar seu painel para monitoramento do aplicativo Code Engine e das cargas de trabalho de execução de tarefas, consulte o Cenário 1 e o Cenário 2. Para obter mais informações sobre como trabalhar com os painéis do IBM Cloud Monitoring, consulte Trabalhando com painéis.

    Sempre que você mudar o layout do seu painel, certifique-se de clicar em Salvar layout para salvar suas mudanças. Você deve salvar as alterações no layout ou cancelar antes de continuar a personalizar seu painel.

  7. Salve o painel customizado. O painel customizado está disponível no menu de navegação do painel, Painéis-> Meus painéis.

Cenário 1: Focando em instâncias de aplicativo e execuções de tarefa do Code Engine

Suponha que você deseje limitar o escopo de monitoramento das cargas de trabalho do Code Engine para se concentrar em instâncias de suas aplicativos em execução e execuções de tarefas. Ele pode ser útil para monitorar essas informações porque se seu aplicativo escalar para zero ou sua tarefa ou construção não estiver em execução, você não estará consumindo recursos. Este cenário considera o painel My custom IBM Code Engine Project Overview que você criou anteriormente por meio do painel IBM Code Engine Project Overview existente e simplifica o painel customizado, modificando e removendo painéis. Para esse cenário, é necessário definir uma tarefa e um aplicativo no seu projeto.

  1. Abra seu painel customizado. Este cenário assume que você está começando com uma cópia do painel IBM Code Engine Project Overview. O painel customizado está disponível no menu de navegação do painel, Painéis-> Meus painéis.

  2. Modifique o painel de número Total number of Applications e modifique a consulta para exibir o número real de instâncias, utilizando a métrica ibm_codeengine_application_actual_instances.

    1. Clique no ícone de lápis para editar o painel.
    2. Na guia Consulta, clique na métrica ibm_codeengine_application_service_count para modificá-la. Digite “ ibm_codeengine_ ” para obter uma lista das métricas do “ Code Engine ” aplicáveis ao seu projeto. Para este exemplo, selecione a métrica ibm_codeengine_application_actual_instances e especifique uma agregação de tempo Maximum e uma rolagem de grupo Maximum.
    3. Na guia Painel, renomear este painel para Total number of Application Instances.
    4. Clique em Salvar para salvar as mudanças para este painel.

  3. Modifique o painel de número Total number of Application revisions e mude a consulta para exibir o número de execuções da tarefa, utilizando a métrica ibm_codeengine_jobruns.

    1. Clique no ícone de lápis para editar o painel.
    2. Na guia Consulta, clique na métrica ibm_codeengine_application_revision_count para modificá-la. Digite “ ibm_codeengine_ ” para obter uma lista das métricas do “ Code Engine ” aplicáveis ao seu projeto. Para este exemplo, selecione a métrica ibm_codeengine_jobruns e especifique uma agregação de tempo Maximum e uma rolagem de grupo Maximum.
    3. Na guia Painel, renomear este painel para Total number of Job Runs.
    4. Clique em Salvar para salvar as mudanças para este painel.

  4. Exclua o painel de número Total number of Application routes usando o menu de ação.

  5. Modifique o painel de cronograma do Applications overview e mude a consulta para exibir informações de monitoramento sobre suas instâncias de aplicativo e execução de tarefas, utilizando as métricas ibm_codeengine_application_actual_instances e ibm_codeengine_jobruns.

    1. Clique no ícone de lápis para editar o painel.
    2. Na guia Consulta, mantenha a métrica ibm_codeengine_application_actual_instances e remova as outras linhas de métricas usando o menu de ação para essas métricas.
    3. Na guia Consulta, localize a métrica ibm_codeengine_application_actual_instances e modifique a segmentação para incluir informações de revisão do aplicativo. Clique em ibm_codeengine_application_name e inclua ibm_codeengine_revision_name. Certifique-se de limpar a seleção para Apply to All Queries.
    4. Na guia Consulta, clique em Incluir consulta para incluir uma consulta para execuções de tarefas. No campo “Métricas”, digite “ ibm_codeengine_ ” para obter uma lista de métricas do Code Engine aplicáveis ao seu projeto. Selecione a métrica ibm_codeengine_jobruns e especifique uma agregação de tempo Maximum e uma rolagem de grupo Maximum. Especifique a segmentação ibm_codeengine_jobrun_condition para esta métrica.
    5. Verifique se você apenas definiu as métricas ibm_codeengine_application_actual_instances e ibm_codeengine_jobruns para este painel.
    6. Na guia Painel, mude o nome deste painel para Application and Job Run Instances.
    7. Clique em Salvar para salvar as mudanças para este painel

  6. Mantenha os painéis que foram atualizados nas etapas anteriores para este cenário, mas use o menu de ações para excluir outros painéis. Depois de remover painéis que não são necessários, é possível ajustar o tamanho e o layout dos painéis individuais para atender às suas necessidades.

    Sempre que você mudar o layout do seu painel, certifique-se de clicar em Salvar layout para salvar suas mudanças. Deve-se salvar as mudanças de layout ou cancelá-las antes de continuar a fazer mudanças em seu painel.

Depois de concluir o cenário 1, seu painel customizado incluirá três painéis: Total number of Application Instances, Total number of Job Runs e Application and Job Run Instances.

Cenário 2: Usando consultas PromQL com cargas de trabalho do Code Engine

No painel customizado que você criou no Cenário 1, suponha que você deseje utilizar o recurso de consulta do Prometheus Query Language (PromQL) do IBM Cloud Monitoring para agregar o número de métricas de aplicativos e de execução de tarefas em um painel. Neste cenário, vamos utilizar o PromQL para incluir o número de instâncias do aplicativo e o número de execuções de tarefa em um único painel de números.

  1. Abra o seu painel customizado que foi customizado com o Cenário 1. O painel customizado está disponível no menu de navegação do painel, Painéis-> Meus painéis.

  2. Modifique o painel de número Total number of Applications e mude a consulta para somar o número de instâncias do aplicativo e o número de execuções de tarefa.

    1. Clique no ícone de lápis para editar o painel.
    2. Na guia Consulta, clique em PromQL para utilizar consultas PromQL.
    3. Na guia Consulta, substitua o conteúdo da consulta por sum(max(ibm_codeengine_application_actual_instances) + max(ibm_codeengine_jobruns)). Atualize Opções para usar number como a unidade. Clique em Executar consulta.
    4. Na guia Painel, renomear este painel para Total number of Application instances and Job Runs.
    5. Clique em Salvar para salvar as mudanças para este painel.

  3. Use o menu de ações para excluir o painel de números Total number of Job Runs porque nós agregamos tanto o número total de aplicativos e de execuções de tarefa em um único painel de números na etapa anterior.

  4. É possível ajustar o tamanho e o layout dos painéis individuais para atender às suas necessidades.

    Sempre que você mudar o layout do seu painel, certifique-se de clicar em Salvar layout para salvar suas mudanças. Deve-se salvar as mudanças de layout ou cancelá-las antes de continuar a customizar seu painel.

Depois de concluir o cenário 2, seu painel customizado incluirá dois painéis: Total number of Application instances and Job Runs e Application and Job Run Instances.