Installationsanleitung für den Orchestrator

BEREITSTELLUNG:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Letzte Aktualisierung 4. Dez. 2024

Webhooks AppSettings.json

Die appsetting.json Datei (C:\Program Files (x86)\UiPath\Orchestrator\Webhooks) enthält die sofort einsatzbereiten Einstellungen für den Webhooks-Dienst. Es wird empfohlen, Ihre benutzerdefinierten Einstellungen im appsetting.Production.json zu konfigurieren. Diese Datei überschreibt alle bereits vorhandenen Einstellungen innerhalb appsetting.json nach jedem Installationsvorgang.

Hinweis: Es empfiehlt sich, dass nur Administratoren die Werte dieser Parameter ändern.

Außerdem empfiehlt es sich, den IIS-Server herunterzufahren, um die appsetting.Production.json-Einstellungen unter allen Umständen zu ändern.

Parameter, die nicht auf dieser Seite dokumentiert sind, dürfen nicht geändert werden.

Bei allen Parametern wird Groß-/Kleinschreibung berücksichtigt.

Priorität der Einstellungen

Einstellungen können an mehreren Stellen konfiguriert werden. Hier sind die Prioritäten, die von Webhooks Service verwendet werden, um den Wert einer Einstellung zu bestimmen, die von hoch (1) bis niedrig (3) aufgeführt ist:

Wert in der Datei appsettings.Production.json
Wert in der Datei appsettings.json
Standardwerteinstellung innerhalb des Codes. Wird nur verwendet, wenn eine bestimmte Einstellung nicht in appsettings.Production.json oder appsettings.json gefunden werden kann.

Einstellungen

Die Datei appsettings.json hat eine interne Struktur, die aus mehreren JSON-Abschnitten besteht, die durch ein Komma getrennt sind.

SQL Client-Einstellungen für Orchestrator

"OrchestratorSqlClientSettings": {
    "ConnectionString": "<OrchestratorConnectionString>",
    "Enabled": true
  },"OrchestratorSqlClientSettings": {
    "ConnectionString": "<OrchestratorConnectionString>",
    "Enabled": true
  },

`ConnectionString`

Die Verbindungszeichenfolge, die von der Orchestrator-Instanz generiert wird, zu der Sie eine Verbindung herstellen möchten.

Konfiguration des Webhook-Diensts

"WebhookServiceConfig": {
    "MaxWorkerCount": 10,
    "HttpClientUserAgent": "UiPath-WebhookService/Webhooks",
    "RequestTimeout": "0.00:01:00",
    "RetryAfter": [
      "0.00:00:0",
      "0.00:00:45",
      "0.00:02:30",
      "0.00:05:00"
    ],
    "MaxRetryRequests": 2    
    "SubscriberCircuitBreakerExpirationSeconds": 600
  },"WebhookServiceConfig": {
    "MaxWorkerCount": 10,
    "HttpClientUserAgent": "UiPath-WebhookService/Webhooks",
    "RequestTimeout": "0.00:01:00",
    "RetryAfter": [
      "0.00:00:0",
      "0.00:00:45",
      "0.00:02:30",
      "0.00:05:00"
    ],
    "MaxRetryRequests": 2    
    "SubscriberCircuitBreakerExpirationSeconds": 600
  },

`RequestsTimeout`

Der Zeitraum, nach dem jede HTTP-Anforderung abgebrochen wird. Bitte beachten Sie, dass jede Anforderung, bei der Timeout erfolgt, gemäß dem RetryAfter-Wert wiederholt wird. Standardmäßig ist die Timeout-Zeit auf 1 Minute festgelegt.

`RetryAfter`

Der Zeitraum in Sekunden, nach dem jede fehlgeschlagene Anforderung wiederholt wird. Standardmäßig gibt es vier Wiederholungen, die wie folgt definiert sind:

Die erste Wiederholung der Anforderung erfolgt unverzüglich nach dem ersten fehlgeschlagenen Versuch.
Die zweite Wiederholung erfolgt 45 Sekunden nach der ersten fehlgeschlagenen Wiederholung.
Die dritte Wiederholung erfolgt 2 Minuten und 30 Sekunden, nachdem die zweite fehlschlägt.
Der vierte Wiederholungsversuch wird 5 Minuten nach dem Fehler im dritten ausgeführt.

Sie können die Anzahl der Verzögerungen ändern, indem Sie weniger Einträge auflisten oder wenn Sie den Wert von MaxRetryRequests auf einen kleineren Wert festlegen. Wir empfehlen, den ersten Wiederholungsversuch auf 0 festzulegen und grundsätzlich keine Zeiten von mehr als 300 Sekunden (5 Minuten) zwischen Wiederholungen einzustellen.

`MaxRetryRequests`

Die maximale Anzahl von Wiederholungen, die für eine fehlgeschlagene Anforderung ausgeführt werden sollen.

`MaxWorkerCount`

Die maximale Anzahl der Webhooks, die pro Mandant aktiviert werden können. Standardmäßig ist dies auf 10 festgelegt.

`SubscriberCircuitBreakerExpirationSeconds`

Die Zeitspanne in Sekunden, in der Webhooks aufhört, Nachrichten an den Abonnenten zu senden, der einen Fehler gemeldet hat. Standardmäßig ist der Wert auf 600 festgelegt. Wenn der Wert des Parameters auf 0 festgelegt ist, ist diese Funktion deaktiviert und Fehler werden ignoriert. Weitere Informationen zur Funktionsweise dieses Musters finden Sie hier.

Hauptbuch-Konfiguration

"LedgerConfiguration": {
    "Enabled": true,
    "Subscribers": [
      {
        "LedgerComponentType": 0,
        "ComponentId": "WebhookSubscriber",
        "Topics": null,
        "ConnectionString": "<OrchestratorConnectionString>",
        "EstablishNewConnection": false,
        "LedgerSubscriberDeliveryType": 1,
        "LedgerSubscriberReliability": 1,
        "Enabled": true,
        "LedgerComponentClassType": 2,
        "Context": "{\"BatchSize\": 500, \"DeliveriesBatchSize\": 500}"
      }
    ]
  },"LedgerConfiguration": {
    "Enabled": true,
    "Subscribers": [
      {
        "LedgerComponentType": 0,
        "ComponentId": "WebhookSubscriber",
        "Topics": null,
        "ConnectionString": "<OrchestratorConnectionString>",
        "EstablishNewConnection": false,
        "LedgerSubscriberDeliveryType": 1,
        "LedgerSubscriberReliability": 1,
        "Enabled": true,
        "LedgerComponentClassType": 2,
        "Context": "{\"BatchSize\": 500, \"DeliveriesBatchSize\": 500}"
      }
    ]
  },

Hinweis: Die Protokollierungsinfrastruktur ist mit der des Orchestrator-Diensts identisch.

`ConnectionString`

Die Verbindungszeichenfolge, die von der Orchestrator-Instanz generiert wird, zu der Sie eine Verbindung herstellen möchten.

"ApplicationInsights": {
    "InstrumentationKey": "<AI_InstrumentationKey>"
  },"ApplicationInsights": {
    "InstrumentationKey": "<AI_InstrumentationKey>"
  },