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. Locate the uipath application in the ArgoCD interface.

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 einer healthy -Zustandsantwort abgeschlossen ist.

You can also configure robot logs to be saved to an Elasticsearch server by editing the cluster_config.json file.

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. Follow the basic configuration steps described above.
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. Use ./orchestrator_configurator.sh -l /tmp/nlog.custom.json to update ConfigMap in the Orchestrator Configurator Tool.

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