Voraussetzung für die Aktivierung der Plattformprotokollierung

Zum Anzeigen der IBM Analytics Engine -Plattformprotokolle müssen Sie das Dashboard 'Beobachtbarkeit' in IBM Cloud verwenden, um die Plattformprotokollierung zu konfigurieren. Unter Plattformprotokolle über das Dashboard 'Beobachtbarkeit' konfigurieren finden Sie die Schritte, die Sie ausführen müssen, um die Protokollierung über das Dashboard 'Beobachtbarkeit' zu aktivieren.

APIs für Protokollierung

Nachdem Sie die Plattformprotokollierung über das Dashboard 'Beobachtbarkeit' aktiviert haben, fahren Sie mit den Schritten in den folgenden Abschnitten fort, um zu erfahren, wie Sie die API-Endpunkte verwenden, um die Protokollierung zu aktivieren, zu inaktivieren und die Protokollierungskonfiguration anzuzeigen.

Die Protokollierungs-API-Aufrufe erfordern die GUID der Serviceinstanz. Wenn Sie die GUID nicht notiert haben, lesen Sie den Abschnitt GUID einer serverunabhängigen Instanz abrufen.

Jetzt werden zwei API-Endpunkte für die Protokollierung verfügbar gemacht:

• log_forwarding_config
• In: logging. Dieser API-Endpunkt ist veraltet und wird in Kürze eingestellt. Sie können diesen Endpunkt zwar verwenden, sollten jedoch mit der Verwendung des Endpunkts log_forwarding_config beginnen.

Protokollweiterleitung von IBM Analytics Engine aktivieren

Um die Weiterleitung von IBM Analytics Engine Plattformprotokollen an IBM Cloud Logs zu aktivieren, rufen Sie die folgende API für eine bestehende Analytics Engine Instanz auf.

Es gibt zwei Methoden, die Sie zum Aktivieren der Weiterleitung von Protokollen verwenden können:

• Standard: In diesem Fall stellen Sie nur eine Anforderung zum Aktivieren der Protokollweiterleitung und die Protokolle, die sich auf die Standardprotokollquelle oder -quellen (spark-driver) beziehen, werden weitergeleitet. Dazu gibt es die folgenden möglichen Vorgehensweisen:

  • Verwendung des log_forwarding_config-API-Endpunkts:

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

  • Verwendung des logging-API-Endpunkts (veraltet):

    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}
    

• Angepasst: Mit dieser Option erhalten Sie mehr Kontrolle über die Protokollweiterleitungskonfiguration. Sie können beispielsweise die Quellen der Protokolle angeben, die weitergeleitet werden sollen. Sie können auch einige Tags mit den Protokollen verknüpfen, die später in IBM Cloud Logs als Suchbegriffe verwendet werden können, um die Suche nach den entsprechenden Protokollen einzugrenzen. Dazu gibt es die folgenden möglichen Vorgehensweisen:

  • Verwendung des log_forwarding_config-API-Endpunkts:

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

  • Verwendung des logging-API-Endpunkts (veraltet):

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

Plattformprotokollierung in IBM Analytics Engine inaktivieren

Deaktivieren Sie die Weiterleitung von IBM Analytics Engine Plattformprotokollen an IBM Cloud Logs, auf eine der folgenden Arten.

• Verwendung des log_forwarding_config-API-Endpunkts:

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

• Verwendung des logging-API-Endpunkts (veraltet):

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

Protokollweiterleitungskonfiguration einer IBM Analytics Engine-Instanz anzeigen

Zeigen Sie die aktuelle Protokollierungskonfiguration einer IBM Analytics Engine-Instanz auf eine der folgenden Arten an:

• Verwendung des log_forwarding_config-API-Endpunkts:

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

• Verwendung des logging-API-Endpunkts (veraltet):

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

Beispiele für IBM Analytics Engine Protokollsuchen im IBM Cloud Logs Dashboard

Sie können die Suche nach den Plattformprotokollen für IBM Analytics Engine wie folgt eingrenzen:

1. Klicken Sie auf " Sources im IBM Cloud Logs Dashboard und wählen Sie " ibmanalyticsengine, um die Protokolle von IBM Analytics Engine zu erhalten.
2. Um Ihre Suche weiter einzugrenzen, können Sie Schlüsselwörter für Ihre Spark-Anwendung im Suchfenster eingeben und suchen.