Speichern von Roboterprotokollen in Elasticsearch

Das Speichern von Roboterprotokollen auf einem Elasticsearch-Server kann über zwei Konfigurationstypen erfolgen: einfach und erweitert.

Die Basiskonfiguration bietet Standardfunktionen, die das vorkonfigurierte Elasticsearch NLog-Ziel aktivieren, das aus einem Elasticsearch-Ziel besteht, das in ein Pufferungsziel eingeschlossen ist. Diese Art der Konfiguration ist in den meisten Szenarien ausreichend.

Wenn Sie die Regeln jedoch weiter anpassen müssen, können Sie die erweiterte Konfigurationsmethode verwenden.

Hinweis: Die Option zum Speichern von Roboterprotokollen auf einem Elasticsearch-Server wird erst nach dem Konfigurieren wirksam und nicht rückwirkend angewandt. Das bedeutet, dass Sie keinen Zugriff mehr auf Protokolle haben, die sich zum Zeitpunkt des Konfigurierens der Option bereits in der Datenbank befanden, da Protokolle nur von einem einzigen Ziel abgerufen und angezeigt werden können.

Grundkonfiguration

1. Suchen Sie die uipath- Anwendung in der ArgoCD- Benutzeroberfläche.
2. Klicken Sie auf die Schaltfläche APP-DETAILS in der oberen linken Ecke und navigieren Sie zur Registerkarte PARAMETER .
3. Klicken Sie auf BEARBEITEN, aktualisieren Sie dann die folgenden Parameter mit den Werten, die in der rechten Spalte angegeben sind, und ersetzen Sie die Beispiele durch Ihre eigenen Werte:

   Parameter	Wert
   global.userInputs.orchestratorRobotLogsElasticUri	Beispiel: https://elastic.example.com:9200. Stellen Sie sicher, dass Sie keinen abschließenden Schrägstrich einfügen.
   global.userInputs.orchestratorRobotLogsElasticAuthUsername	Beispiel: elastic-user.
   global.userInputs.orchestratorRobotLogsElasticAuthPassword	Beispiel: elastic-password.

4. Speichern Sie die Änderungen.
5. Synchronisieren Sie die uipath-Anwendung und warten Sie, bis der Prozess mit der Statusmeldung healthy abgeschlossen ist.

Sie können auch Roboterprotokolle konfigurieren, die auf einem Elasticsearch-Server gespeichert werden, indem Sie die Datei cluster_config.json bearbeiten.

Die Basiskonfiguration unterstützt Elasticsearch Version 7.x. Für Elasticsearch 8.x müssen Sie die erweiterte Konfiguration verwenden.

Erweiterte Konfiguration

Wichtig: Alle Änderungen, die Sie gemäß den folgenden Schritten vornehmen, können sich negativ auf die Funktionalität und Stabilität des gesamten Systems auswirken. Es ist ratsam, nur Änderungen vorzunehmen, wenn Sie sich der Konsequenzen bewusst sind.

Mit der erweiterten Konfiguration können Sie Ihr NLog.config -Ziel vollständig anpassen.

1. Führen Sie die oben beschriebenen grundlegenden Konfigurationsschritte aus.
2. Bearbeiten Sie die nlog.json -Parameter in orchestrator-customconfig in ConfigMap.
   1. Erstellen Sie eine /tmp/nlog.custom.json -Datei basierend auf dem folgenden Beispiel.
   2. Verwenden Sie ./orchestrator_configurator.sh -l /tmp/nlog.custom.json, um ConfigMap im Orchestrator-Konfiguratortool zu aktualisieren.

Hinweis:

Die erweiterte Konfiguration unterstützt auch Elasticsearch Version 8.x.

Beispiel für Elasticsearch 7.x

{
  "Nlog": {
    "targets": {
      "robotElasticBuffer": {
        "flushTimeout": 1000,
        "bufferSize": 1000,
        "slidingTimeout": false,
        "target": {
          "uri": "https://elastic.example.com:9200",
          "requireAuth": true,
          "username": "elastic-user",
          "password": "elastic-password",
          "index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
          "documentType": "logEvent",
          "includeAllProperties": true,
          "layout": "${message}",
          "excludedProperties": "agentSessionId,tenantId,indexName"
        }
      }
    }
  }
}

Beispiel für Elasticsearch 8.x

{
  "Nlog": {
    "targets": {
      "robotElasticBuffer": {
        "flushTimeout": 1000,
        "bufferSize": 1000,
        "slidingTimeout": false,
        "target": {
          "uri": "https://elastic.example.com:9200",
          "requireAuth": true,
          "username": "elastic-user",
          "password": "elastic-password",
          "index": "${event-properties:item=indexName}-${date:format=yyyy.MM}",
          "documentType": "",
          "includeAllProperties": true,
          "layout": "${message}",
          "excludedProperties": "agentSessionId,tenantId,indexName"
        }
      }
    }
  }
}