Prerequisito per abilitare la registrazione della piattaforma

Per visualizzare i log della piattaforma IBM Analytics Engine, devi utilizzare il dashboard Osservabilità in IBM Cloud per configurare la registrazione della piattaforma. Vedi Configurazione dei log della piattaforma tramite il dashboard Osservabilità per i passi che devi seguire per abilitare la registrazione tramite il dashboard Osservabilità.

API di registrazione

Dopo aver abilitato la registrazione della piattaforma tramite il dashboard Osservabilità, procedi con i passi riportati nelle seguenti sezioni per informazioni su come utilizzare gli endpoint API per abilitare, disabilitare e visualizzare la configurazione della registrazione.

Le chiamate API di registrazione richiedono il GUID dell'istanza del servizio. Se non hai preso nota del GUID, vedi Richiamo del GUID di un'istanza senza server.

Ora, vengono esposti due endpoint API di registrazione:

• log_forwarding_config
• logging. Questo endpoint API è obsoleto e sarà presto sospeso. Anche se è possibile utilizzare questo endpoint, è necessario iniziare a utilizzare l'endpoint log_forwarding_config.

Abilitazione dell'inoltro dei log da IBM Analytics Engine

Per abilitare l'inoltro dei log della piattaforma IBM Analytics Engine a IBM Cloud Logs, invocare la seguente API su un'istanza Analytics Engine esistente.

Ci sono due metodi che puoi usare per abilitare l'inoltro dei log:

• Predefinito: in questo caso si inserisce solo una richiesta per abilitare l'inoltro dei log e i log relativi all'origine o alle origini log predefinite (spark-driver), inizieranno ad essere inoltrati. È possibile farlo in uno dei seguenti modi:

  • Utilizzando l'endpoint API log_forwarding_config :

    curl -X PUT https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/log_forwarding_config -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d '{"enabled":true}'
    

  • Utilizzando l'endpoint API logging (obsoleto):

    curl -X PUT https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/logging -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d '{"enable":true}
    

• Personalizzato: con questa opzione, ottieni un maggiore controllo sulla configurazione di inoltro dei log. Ad esempio, è possibile specificare le origini dei log che si desidera inoltrare. Si può anche scegliere di associare alcuni tag ai registri, che possono essere utilizzati in seguito in IBM Cloud Logs come parole chiave di ricerca per restringere la ricerca sui registri applicabili. È possibile farlo in uno dei seguenti modi:

  • Utilizzando l'endpoint API log_forwarding_config :

    curl -X PUT https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/log_forwarding_config -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d ' {"enabled":true,"sources": ["spark-driver", "spark-executor"],"tags": ["<tag_1>", "<tag_2>",...]} '
    

  • Utilizzando l'endpoint API logging (obsoleto):

    curl -X PUT https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/logging -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d ' {"enable":true,"components": ["spark-driver", "spark-executor"],"tags": ["<tag_1>", "<tag_2>",...]} '
    

Disabilitazione della registrazione della piattaforma da IBM Analytics Engine

Disattivare l'inoltro dei log della piattaforma IBM Analytics Engine a IBM Cloud Logs, in uno dei seguenti modi.

• Utilizzando l'endpoint API log_forwarding_config :

  curl -X PATCH https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/log_forwarding_config -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d '{"enabled":false}'
  

• Utilizzando l'endpoint API logging (obsoleto):

  curl -X PATCH https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/logging -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" -d '{"enable":false}'
  

Visualizzazione della configurazione di inoltro dei log di un'istanza IBM Analytics Engine

Visualizza la configurazione di registrazione corrente di un'istanza IBM Analytics Engine, in uno dei seguenti modi:

• Utilizzando l'endpoint API log_forwarding_config :

  curl -X GET https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/log_forwarding_config -H "Authorization: Bearer $TOKEN"
  

• Utilizzando l'endpoint API logging (obsoleto):

  curl -X GET https://api.us-south.ae.cloud.ibm.com/v3/analytics_engines/<instance_guid>/logging -H "Authorization: Bearer $TOKEN"
  

Esempi di ricerche di log IBM Analytics Engine nel dashboard IBM Cloud Logs

Puoi restringere la ricerca per i log della piattaforma correlati a IBM Analytics Engine come segue:

1. Fare clic su 'Sources nella dashboard IBM Cloud Logs e scegliere 'ibmanalyticsengine per ottenere i log da IBM Analytics Engine.
2. Per restringere ulteriormente la ricerca, è possibile immettere e cercare qualsiasi parola chiave relativa all'applicazione Spark nella finestra di ricerca.