Documentazione di Oracle Cloud Infrastructure

Parametri personalizzati

Informazioni sulle metriche personalizzate

  • Consente agli utenti di configurare la modalità di raccolta delle metriche per gli intervalli in base alle esigenze di reporting.
  • Gli utenti possono impostare le proprie definizioni di metriche in base alle proprietà degli intervalli, il che consente loro di configurare modalità personalizzate di monitoraggio delle proprie applicazioni.
  • Le metriche personalizzate utilizzano filtri intervallo per selezionare gli intervalli per i quali devono essere calcolate le metriche. Ciò consente agli utenti di definire set diversi di metriche per diversi tipi di intervalli.
  • Per i report con filtro, è possibile assegnare le dimensioni ai parametri che consentono di raggruppare e filtrare in base a tali dimensioni. Ad esempio, segnalando gli utenti per tipo di browser o gli articoli venduti per paese.
  • Le metriche personalizzate vengono configurate a livello di dominio APM.

Esempi di metriche personalizzate

Esempio 1: creare una metrica per tenere traccia del numero di errori che si verificano durante il passo di checkout.

Per questo caso d'uso, è necessario identificare gli intervalli non riusciti durante la fase di checkout. Supponendo che l'URL della pagina di checkout termini con checkout.jsp, è possibile definire un valore Span Filter che verifichi se l'attributo HttpUrl termina con checkout.jsp e controlli anche se l'attributo Error è impostato su true.

HttpUrl like '%checkout.jsp' AND Error = 'true'

Come origine del valore, selezionare SpanErrorCount. Questo avrà il valore 1 se si è verificato un errore nella pagina e 0 in caso contrario. Inoltre, potrebbe essere interessante sapere se gli errori si verificano solo con browser specifici in modo da poter aggiungere la dimensione BrowserName.

Esempio 2: creare una metrica per tenere traccia del tempo di risposta della home page

In questo scenario, vogliamo tenere traccia del tempo di risposta della nostra home page. A tale scopo, è possibile utilizzare l'origine del valore PageResponseTime. È possibile impostare un valore Span Filter corrispondente alla home page denominata home.php.

HttpUrl like '%home.php' AND ApmrumType = 'PAGE'

A questo punto, selezionare PageResponseTime per l'origine del valore. È inoltre possibile aggiungere dimensioni a seconda delle esigenze. Ad esempio, GeoCountry per ottenere un'analisi stratificata dei tempi di risposta per paese.

Gestisci metriche personalizzate

Per creare una metrica personalizzata per un dominio APM desiderato, effettuare le operazioni riportate di seguito.

  • Andare alla pagina Domini APM e fare clic sul dominio APM desiderato.

    Viene visualizzata la pagina Dettagli dominio.

  • Andare a Risorse, in basso a sinistra, e fare clic su Metriche personalizzate

    Viene visualizzato il riquadro Metriche personalizzate.

  • Nel riquadro Metriche personalizzate fare clic su Crea metrica personalizzata.

    Viene visualizzata la finestra Crea metrica personalizzata.

    • Immettere il nome della metrica della nuova metrica personalizzata.
    • Nella casella Filtro intervallo scegliere un filtro intervallo predefinito (globale) o digitare una definizione di filtro intervallo locale.
    • Nell'elenco a discesa Origine valore metrica selezionare una metrica.
    • Facoltativo: dall'elenco a discesa Dimensioni selezionare una o più dimensioni. Il numero massimo di dimensioni è 10.
    • Facoltativo: dall'elenco a discesa Unità di metrica selezionare un'unità di metrica.
    • Facoltativo: fare clic su Convalida metrica personalizzata per verificare se gli intervalli inclusi di recente corrispondono al filtro intervallo configurato. Lo strumento di convalida consente di controllare gli intervalli inclusi per un massimo di 24 ore nel passato.
    • Fare clic su Avanti per passare alle opzioni di scegliere lo storage delle metriche.
    • Nell'elenco a discesa Compartimento selezionare un compartimento.
    • Nel campo Spazio di nomi, immettere uno spazio di nomi.

      Lo spazio di nomi predefinito per tutte le metriche personalizzate è oracle_apm_custom.

      Utilizzare uno spazio di nomi personalizzato: se lo si desidera, è possibile fornire uno spazio di nomi personalizzato che deve essere utilizzato dalla metrica personalizzata.

      Quando si utilizza uno spazio di nomi non predefinito, è necessario creare un criterio per il nuovo spazio di nomi.

      • Nel campo Spazio di nomi modificare il valore predefinito e immettere lo spazio di nomi preferito.
      • Viene visualizzato il messaggio Criterio richiesto per il nuovo spazio di nomi che indica che è richiesto il seguente criterio: 
        Allow service applicationperformancemonitoring to manage metrics in compartment <compartment_name> where target.metrics.namespace=<custom_namespace_name>
        Ad esempio:
        Allow service applicationperformancemonitoring to manage metrics in compartment ABC where target.metrics.namespace=namespace2

        Il criterio riportato sopra consente al servizio OCI Application Performance Monitoring di pubblicare nello spazio di nomi personalizzato.

        Di seguito sono riportate le opzioni disponibili.
        • Copia criterio: il criterio viene copiato negli Appunti e deve essere creato manualmente utilizzando OCI Console.

          Utilizzare questa opzione se non si dispone delle autorizzazioni per creare criteri in OCI. Nella maggior parte dei casi, un utente amministratore deve creare il criterio.

        • Convalida criterio: il criterio viene convalidato utilizzando una metrica di test e controllando le autorizzazioni nello spazio di nomi personalizzato.
        • Applica criterio: il criterio viene creato automaticamente.

          Utilizzare questa opzione se si dispone delle autorizzazioni per creare criteri in OCI. Ad esempio, si dispone delle autorizzazioni di amministratore.

        Per informazioni su come creare i criteri, vedere Creazione di un criterio nella documentazione di Identity Management.

    • Facoltativo: dall'elenco a discesa Gruppo di risorse selezionare un gruppo di risorse.
    • Fare clic su Crea.

      Se il processo di creazione non riesce quando si utilizza uno spazio di nomi personalizzato, verificare se il servizio Application Performance Monitoring dispone dell'accesso per la scrittura nello spazio di nomi personalizzato.

Utilizzare il menu Azioni per modificare o eliminare una metrica personalizzata.

Se si dispone di una metrica personalizzata esistente e si desidera aggiornarla per iniziare a utilizzare uno spazio di nomi personalizzato (anziché utilizzare lo spazio di nomi predefinito oracle_apm_custom), assicurarsi che il criterio precedente venga applicato allo spazio di nomi personalizzato.