Orchestrator
2021.10
False
Image de fond de la bannière
Guide de l'API Orchestrator
Dernière mise à jour 19 avr. 2024

Points de terminaison de vérification de l'état

Assurez-vous que tous vos services sont opérationnels en effectuant des appels d'API vers des points de terminaison spéciaux, appelés points de terminaison de vérification de l'état.

Ces points de terminaison exécutent des vérifications de l'état et renvoient un statut qui vous indique si le service que vous vérifiez est fonctionnel ou non.

Orchestrator health check endpoint

Pour vérifier la disponibilité de votre instance Orchestrator et de ses dépendances, utilisez les points de terminaison suivants :

  • Obtenir

    https://{yourDomain}/api/health: vérifie uniquement les dépendances critiques
  • Obtenir

    https://{yourDomain}/api/health/startup: vérifie chaque dépendance

Par défaut, les points de terminaison de vérification de l'état ci-dessus renvoient un corps de réponse vide.

Pour voir quelles vérifications de l'état ont été effectuées et les statuts qu'elles possèdent :

  1. Ouvrez le fichier UiPath.Orchestrator.dll.config (C:\Program Files (x86)\UiPath\Orchestrator), et
    ajoutez <add key="HealthCheck.DetailsKey" value="12345" /> dans la section <appsettings> . 12345 sert de mot de passe pour accéder aux vérifications de l'état, alors n'oubliez pas de le changer avec votre propre valeur.
  2. Redémarrez IIS pour vous assurer que la modification prend effet.
  3. Utilisez le mot de passe défini précédemment comme paramètre de requête dans l'appel de l'API de vérification de l'état (par exemple, /api/health?detailsKey=password). En cas de succès, l'appel renvoie un corps de réponse contenant des détails sur les vérifications de l'intégrité et leurs statuts.

Une fois que vous avez terminé ces étapes, la vérification de l'état sera également accessible à partir d'une machine différente du serveur Orchestrator.

Point de terminaison de vérification de l’état de l’Identity Server

Pour vérifier si le serveur d'identité fonctionne, utilisez le point de terminaison suivant :

  • LIRE https://{yourDomain}/identity/health

Le corps de la réponse de ce point de terminaison résume la configuration du serveur d'identité.

{
    "status": "Healthy",
    "results": {
        "ApplicationDbContext": {
            "status": "Healthy",
            "description": null,
            "data": {}
            },
        "AuditDbContext": {
            "status": "Healthy",
            "description": null,
            "data": {}
            },
        "PersistedGrantDbContext": {
            "status": "Healthy",
            "description": null,
            "data": {}
            },
        "IdentityServerConfigurationDbContext": {
            "status": "Healthy",
            "description": null,
            "data": {}
            }
    }
}{
    "status": "Healthy",
    "results": {
        "ApplicationDbContext": {
            "status": "Healthy",
            "description": null,
            "data": {}
            },
        "AuditDbContext": {
            "status": "Healthy",
            "description": null,
            "data": {}
            },
        "PersistedGrantDbContext": {
            "status": "Healthy",
            "description": null,
            "data": {}
            },
        "IdentityServerConfigurationDbContext": {
            "status": "Healthy",
            "description": null,
            "data": {}
            }
    }
}

Un code d'erreur 500 signale un état défectueux, mais peut toujours renvoyer un corps de réponse. Vérifiez le contenu du corps de la réponse pour en connaître les raisons.

Point de terminaison de vérification de l’état des webhooks

Pour vérifier la disponibilité de votre service Webhooks, utilisez le point de terminaison suivant :

  • LIRE https://{yourDomain}/webhooks/api/status

Interprétation du code de réponse

Interprétez le code de réponse comme suit :

  • 200 OK: votre service est opérationnel
  • Échec de5xx : votre service est en panne
Certaines vérifications de l'état peuvent renvoyer un code de réponse 200 OK et un statut Degraded , ce qui signifie que le composant vérifié est dans un état dégradé.

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Logo Uipath blanc
Confiance et sécurité
© 2005-2024 UiPath. All rights reserved.