Enregistrement des journaux du robot dans Elasticsearch

L'enregistrement des journaux du robot sur un serveur Elasticsearch peut être réalisé via deux types de configuration : de base et avancée.

La configuration de base fournit une fonctionnalité par défaut qui active la cible Elasticsearch NLog préconfigurée, qui est composée d'une cible Elasticsearch encapsulée dans une cible Buffering. Ce type de configuration est suffisant dans la plupart des scénarios.

Toutefois, si vous devez personnaliser davantage les règles, vous pouvez utiliser la méthode de configuration avancée.

Remarque : l’option permettant d’enregistrer les journaux du robot sur un serveur Elasticsearch ne devient efficace qu’une fois que vous l’avez configurée, et n’est pas appliquée rétroactivement. Cela signifie que vous n’aurez plus accès aux journaux qui se trouvaient déjà dans la base de données au moment où vous avez configuré l’option, car les journaux ne peuvent être récupérés et affichés qu’à partir d’une seule destination.

Configuration de base du journal du robot Elasticsearch

To apply the basic configuration, take the following steps. For more details, see Configuring the Orchestrator parameters.

1. Dans le fichier de configuration, ajoutez une nouvelle section appelée orchestrator_robot_logs_elastic à la configuration d'Orchestrator, comme indiqué dans l'exemple suivant :

   "orchestrator": {
       "enabled": true,
       "orchestrator_robot_logs_elastic": {
           "elastic_uri": "https://elastic.example.com:9200",
           "elastic_auth_username": "elastic-user",
           "elastic_auth_password": "elastic-password"
       }
   }

2. Mettez à jour les paramètres suivants avec vos propres valeurs :

   Paramètre	Description
   elastic_uri	L'adresse de l'instance Elasticsearch devant être utilisée. Vous devez fournir l'adresse sous forme d'un URI, avec un nom d'utilisateur et un mot de passe. Exemple : https://elastic.example.com:9200 Assurez-vous de ne pas inclure de barre oblique finale.
   elastic_auth_username	Exemple : elastic-user
   elastic_auth_password	Exemple : elastic-password

La configuration de base prend en charge Elasticsearch version 7.x. Pour Elasticsearch 8.x, vous devez utiliser la configuration avancée.

Configuration avancée du journal du robot Elasticsearch

Attention : Toute modification que vous apportez lors des étapes suivantes peut avoir un impact négatif sur la fonctionnalité et la stabilité de l'ensemble du système. Il est conseillé de n'apporter des modifications que si vous connaissez leurs conséquences.

La configuration avancée vous permet de personnaliser entièrement votre cible NLog.config .

1. Follow the basic configuration steps described previously.
2. Follow the Advanced NLog configuration steps, then update the robotElasticBuffer target with the properties that need to be changed.

Remarque :

La configuration avancée prend également en charge Elasticsearch version 8.x.

Exemple de nlog.config.json pour 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"
        }
      }
    }
  }
}

Exemple de nlog.config.json pour 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"
        }
      }
    }
  }
}