Creazione di dashboard personalizzate per il monitoraggio Code Engine

Utilizza IBM Cloud Monitoring per ottenere informazioni dettagliate sullo stato e sulle prestazioni dei carichi di lavoro di Code Engine. È possibile personalizzare una dashboard di Monitoring per i carichi di lavoro di Code Engine, definendo una serie di metriche su misura che consentano di identificare i colli di bottiglia o prevedere eventuali problemi in produzione.

Crea dashboard personalizzate per monitorare Code Engine

È possibile creare una dashboard personalizzata su Monitoring per i carichi di lavoro di Code Engine, basata su un insieme di metriche su misura.

Prima di poter creare un dashboard personalizzato in Monitoring, è necessario configurare il monitoraggio dei carichi di lavoro di Code Engine. Configura la tua istanza del servizio " Monitoring " e abilita "Platform Metrics" nella stessa regione dei progetti " Code Engine " che desideri monitorare. Se disponi di distribuzioni in più di una regione, devi configurare Monitoring e abilitare le metriche della piattaforma per ciascuna regione. Per ulteriori informazioni sulla configurazione dell'istanza del servizio IBM Cloud Monitoring e sull'accesso alla dashboard delle metriche IBM Cloud Monitoring per il monitoraggio dei carichi di lavoro Code Engine, consultare la sezione "Monitoraggio" all'indirizzo Code Engine.

Code Engine fornisce la dashboard " IBM Code Engine Project Overview ", composta da pannelli predefiniti che monitorano vari aspetti dei carichi di lavoro di Code Engine. Potresti voler creare una dashboard personalizzata su Monitoring per i carichi di lavoro di Code Engine, basata su un insieme di metriche su misura.

  1. Configurazione di un'istanza del servizio IBM Cloud Monitoring. Per verificare la presenza di istanze attive di IBM Cloud Monitoring, consulta la dashboard "Observability ".

  2. Assicurarsi che siano disponibili dati di monitoraggio. Poiché progettare un dashboard personalizzato è più semplice quando si dispone di dati da monitorare, è importante che l'applicazione o il processo siano in esecuzione. Alcune metriche di Code Engine sono disponibili solo se presenti nell'ambiente.

  3. Esamina le metriche disponibili per Code Engine.

  4. Accedi alle metriche di IBM Cloud Monitoring.

    1. Dal menu di navigazione " IBM Cloud ", seleziona " Observability".
    2. Selezionare " Monitoraggio ".
    3. Fai clic su "Dashboard" nella colonna "Visualizza " della tua istanza di monitoraggio per aprire la dashboard relativa a tale istanza.
    4. Dal menu di navigazione, selezionare Dashboards -> IBM-> IBM Code Engine Project Overview. Se nel menu non è presente la dashboard " Code Engine ", puoi avviare il monitoraggio dall'applicazione o dal processo Code Engine selezionando "Aggiungi monitoraggio ".

  5. Fai clic su "Copia nei miei dashboard " per creare una copia del dashboard " IBM Code Engine Project Overview ". Inserisci un nome per la tua dashboard personalizzata, quindi fai clic su "Crea e apri ". Ad esempio, assegna al tuo dashboard il nome “ My custom IBM Code Engine Project Overview ”.

  6. Personalizza la tua dashboard aggiungendo o rimuovendo i pannelli. Per alcuni esempi su come personalizzare la dashboard per il monitoraggio dei carichi di lavoro relativi alle applicazioni e alle esecuzioni di job dell' Code Engine, consultare lo Scenario 1 e lo Scenario 2. Per ulteriori informazioni sull'utilizzo dei dashboard di IBM Cloud Monitoring, consultare la sezione " Utilizzo dei dashboard ".

    Ogni volta che modifichi il layout della tua dashboard, assicurati di fare clic su “Salva layout” per salvare le modifiche. È necessario salvare le modifiche al layout oppure annullarle prima di continuare a personalizzare la dashboard.

  7. Salva il dashboard personalizzato. Il dashboard personalizzato è disponibile nel menu di navigazione dei dashboard, alla voce Dashboard -> I miei dashboard.

Scenario 1: Analisi delle istanze dell'applicazion Code Engine e e delle esecuzioni dei processi

Supponiamo che tu voglia restringere l'ambito del monitoraggio dei carichi di lavoro di Code Engine per concentrarti sulle istanze delle tue applicazioni in esecuzione e sulle esecuzioni dei job. Può essere utile monitorare queste informazioni perché, se la tua applicazione scende a zero o il tuo processo o la tua build non sono in esecuzione, significa che non stai consumando risorse. Questo scenario prende come base la dashboard " My custom IBM Code Engine Project Overview " che hai creato in precedenza a partire dalla dashboard esistente " IBM Code Engine Project Overview " e semplifica la dashboard personalizzata modificando e rimuovendo alcuni pannelli. In questo scenario, è necessario definire un’attività e un’applicazione nel proprio progetto.

  1. Apri la tua dashboard personalizzata. Questo scenario presuppone che si parta da una copia della dashboard " IBM Code Engine Project Overview ". Il dashboard personalizzato è disponibile nel menu di navigazione dei dashboard, alla voce Dashboard -> I miei dashboard.

  2. Modificare il pannello " Total number of Applications " e modificare la query in modo da visualizzare il numero effettivo di istanze utilizzando la ibm_codeengine_application_actual_instances metrica.

    1. Fai clic sull'icona a forma di matita per modificare il pannello.
    2. Nella scheda "Query", fare clic sulla metrica " ibm_codeengine_application_service_count " per modificarla. Digita " ibm_codeengine_ " per visualizzare un elenco delle metriche di " Code Engine " applicabili al tuo progetto. Per questo esempio, selezionare la metrica " ibm_codeengine_application_actual_instances " e specificare un'aggregazione temporale " Maximum " e un rollup di gruppo " Maximum ".
    3. Dalla scheda "Pannello", rinomina questo pannello in " Total number of Application Instances".
    4. Fare clic su "Salva " per salvare le modifiche apportate a questo pannello.

  3. Modifica il pannello " Total number of Application revisions " e modifica la query in modo che visualizzi il numero di esecuzioni del processo utilizzando la ibm_codeengine_jobruns metrica.

    1. Fai clic sull'icona a forma di matita per modificare il pannello.
    2. Nella scheda "Query", fare clic sulla metrica " ibm_codeengine_application_revision_count " per modificarla. Digita " ibm_codeengine_ " per visualizzare un elenco delle metriche di " Code Engine " applicabili al tuo progetto. Per questo esempio, selezionare la metrica " ibm_codeengine_jobruns " e specificare un'aggregazione temporale " Maximum " e un rollup di gruppo " Maximum ".
    3. Dalla scheda "Pannello", rinomina questo pannello in " Total number of Job Runs".
    4. Fare clic su "Salva " per salvare le modifiche apportate a questo pannello.

  4. Elimina il pannello dei numeri " Total number of Application routes " utilizzando il menu delle azioni.

  5. Modifica il pannello del grafico temporale di Applications overview e modifica la query in modo che visualizzi le informazioni di monitoraggio relative alla tua applicazione e alle istanze di esecuzione dei processi utilizzando il ibm_codeengine_application_actual_instances e ibm_codeengine_jobruns metriche.

    1. Fai clic sull'icona a forma di matita per modificare il pannello.
    2. Nella scheda "Query", mantieni la metrica " ibm_codeengine_application_actual_instances " ed elimina le altre righe relative alle metriche utilizzando il menu delle azioni corrispondente a ciascuna di esse.
    3. Nella scheda "Query", individuare la metrica " ibm_codeengine_application_actual_instances " e modificare la segmentazione in modo da includere le informazioni sulla revisione dell'applicazione. Clicca su ibm_codeengine_application_name e aggiungi ibm_codeengine_revision_name. Assicurati di deselezionare l'opzione " Apply to All Queries".
    4. Nella scheda Query, fare clic su Aggiungi query per aggiungere una query relativa alle esecuzioni dei processi. Nel campo "Metriche", digita " ibm_codeengine_ " per visualizzare un elenco delle metriche " Code Engine " applicabili al tuo progetto. Selezionare la metrica " ibm_codeengine_jobruns " e specificare un'aggregazione temporale " Maximum " e un rollup di gruppo " Maximum ". Specificare la segmentazione " ibm_codeengine_jobrun_condition " per questa metrica.
    5. Assicurati di impostare solo le metriche “ ibm_codeengine_application_actual_instances ” e “ ibm_codeengine_jobruns ” per questo pannello.
    6. Dalla scheda "Pannello", modifica il nome di questo pannello in " Application and Job Run Instances".
    7. Fai clic su “Salva” per salvare le modifiche apportate a questo pannello

  6. Mantieni i pannelli aggiornati nei passaggi precedenti per questo scenario, ma utilizza il menu delle azioni per eliminare gli altri pannelli. Dopo aver rimosso i pannelli non necessari, è possibile regolare le dimensioni e la disposizione dei singoli pannelli in base alle proprie esigenze.

    Ogni volta che modifichi il layout della tua dashboard, assicurati di fare clic su “Salva layout” per salvare le modifiche. È necessario salvare le modifiche al layout oppure annullarle prima di continuare ad apportare modifiche alla propria dashboard.

Una volta completato lo scenario 1, la dashboard personalizzata includerà tre pannelli: Total number of Application Instances, Total number of Job Runs e Application and Job Run Instances.

Scenario 2: Utilizzo delle query “ PromQL ” con carichi di lavoro “ Code Engine ”

Partendo dalla dashboard personalizzata creata nello Scenario 1, supponiamo di voler utilizzare la funzionalità di query del linguaggio di query di Prometheus ( PromQL ) di IBM Cloud Monitoring per aggregare le metriche relative al numero di applicazioni e di esecuzioni dei processi in un unico pannello. In questo scenario, utilizziamo " PromQL " per aggiungere il numero di istanze dell'applicazione e il numero di esecuzioni dei lavori in un unico pannello numerico.

  1. Apri la tua dashboard personalizzata in base allo Scenario 1. Il dashboard personalizzato è disponibile nel menu di navigazione dei dashboard, alla voce Dashboard -> I miei dashboard.

  2. Modifica il pannello " Total number of Applications " e modifica la query in modo da sommare il numero di istanze dell'applicazione e il numero di esecuzioni dei lavori.

    1. Fai clic sull'icona a forma di matita per modificare il pannello.
    2. Nella scheda "Query", fare clic su " PromQL " per utilizzare le query di " PromQL ".
    3. Nella scheda "Query", sostituisci il contenuto della query con sum(max(ibm_codeengine_application_actual_instances) + max(ibm_codeengine_jobruns)). Opzioni di aggiornamento per impostare " number " come unità di misura. Fai clic su Run query.
    4. Dalla scheda "Pannello", rinomina questo pannello in " Total number of Application instances and Job Runs".
    5. Fare clic su "Salva " per salvare le modifiche apportate a questo pannello.

  3. Utilizza il menu delle azioni per eliminare il pannello numerico " Total number of Job Runs ", poiché nel passaggio precedente abbiamo raggruppato sia il numero totale di applicazioni che quello delle esecuzioni dei lavori in un unico pannello numerico.

  4. È possibile regolare le dimensioni e la disposizione dei singoli pannelli in base alle proprie esigenze.

    Ogni volta che modifichi il layout della tua dashboard, assicurati di fare clic su “Salva layout” per salvare le modifiche. È necessario salvare le modifiche al layout o annullarle prima di continuare a personalizzare la propria dashboard.

Una volta completato lo scenario 2, la tua dashboard personalizzata includerà due pannelli: Total number of Application instances and Job Runs e Application and Job Run Instances.