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:

It is recommended that only administrators change the values of these parameters. Additionally, it is recommended that you shut down the IIS server in order to modify appsetting.Production.json settings under any circumstances. Parameters that are not documented in this page should not be changed.

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:

1. Wert in der Datei appsettings.Production.json
2. Wert in der Datei appsettings.json
3. 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
  },

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

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

Hinweis:

Die Protokollierungsinfrastruktur ist identisch mit der des Orchestrator-Diensts.

ConnectionString

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

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

InstrumentationKey

Erforderlich, wenn Sie Application Insights verwenden.

Weitere Informationen finden Sie in der offiziellen Dokumentation zum Erstellen einer Application Insights-Ressource.