Requisito previo para habilitar el registro de plataforma

Para ver los registros de plataforma de IBM Analytics Engine, debe utilizar el panel de control Observabilidad en IBM Cloud para configurar el registro de plataforma. Consulte Configuración de registros de plataforma a través del panel de control Observabilidad para ver los pasos que debe seguir para habilitar el registro a través del panel de control Observabilidad.

API de registro

Después de haber habilitado el registro de plataforma a través del panel de control Observabilidad, continúe con los pasos de las secciones siguientes para aprender a utilizar los puntos finales de API para habilitar el registro, inhabilitar el registro y ver la configuración de registro.

Las llamadas de API de registro requieren el GUID de la instancia de servicio. Si no ha tomado nota del GUID, consulte Recuperación del GUID de una instancia sin servidor.

Ahora, se exponen dos puntos finales de API de registro:

• log_forwarding_config
• logging. Este punto final de API está en desuso y se dejará de mantener pronto. Aunque puede utilizar este punto final, debe empezar a utilizar el punto final log_forwarding_config.

Habilitación del reenvío de registros desde IBM Analytics Engine

Para activar el reenvío de los registros de la plataforma ' IBM Analytics Engine ' a los registros de ' IBM Cloud ', invoque la siguiente API contra una instancia existente de ' Analytics Engine '.

Existen dos métodos que puede utilizar para habilitar el reenvío de registros:

• Valor predeterminado: en este caso, sólo colocará una solicitud para habilitar el reenvío de registros, y los registros relacionados con el origen o los orígenes de registro predeterminados (spark-driver) empezarán a reenviarse. Puede hacer esto de una de las formas siguientes:

  • Utilizando el punto final de la API de 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}'
    

  • Utilizando el punto final de API de logging (en desuso):

    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}
    

• Personalizado: con esta opción, obtendrá más control sobre la configuración de reenvío de registros. Por ejemplo, puede especificar los orígenes de los registros que desea reenviar. También puede optar por asociar algunas etiquetas a los registros, que pueden utilizarse posteriormente en IBM Cloud Logs como palabras clave de búsqueda para limitar la búsqueda a los registros aplicables. Puede hacer esto de una de las formas siguientes:

  • Utilizando el punto final de la API de 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>",...]} '
    

  • Utilizando el punto final de API de logging (en desuso):

    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>",...]} '
    

Inhabilitación del registro de plataforma desde IBM Analytics Engine

Desactive el reenvío de IBM Analytics Engine registros de plataforma a IBM Cloud Logs, de una de las siguientes formas.

• Utilizando el punto final de la API de 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}'
  

• Utilizando el punto final de API de logging (en desuso):

  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}'
  

Visualización de la configuración de reenvío de registros de una instancia de IBM Analytics Engine

Vea la configuración de registro actual de una instancia de IBM Analytics Engine, de una de las maneras siguientes:

• Utilizando el punto final de la API de 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"
  

• Utilizando el punto final de API de logging (en desuso):

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

Ejemplos de búsquedas de registros IBM Analytics Engine en el panel de IBM Cloud Logs

Puede reducir la búsqueda de los registros de plataforma relacionados con IBM Analytics Engine de la forma siguiente:

1. Haga clic en " Sources en el panel de IBM Cloud Logs y seleccione " ibmanalyticsengine " para obtener los registros de IBM Analytics Engine.
2. Para reducir aún más la búsqueda, puede especificar y buscar cualquier palabra clave relacionada con la aplicación Spark en la ventana de búsqueda.