Canal d'alerte Webhook

{
  "issue": {
    "id": "53650436-8e35-49a3-a610-56b442ae7620",
    "type": "issue",
    "state": "OPEN",
    "start": 1460537793322,
    "severity": 5,
    "text": "Garbage Collection Activity High (11%)",
    "suggestion": "Tune your Garbage Collector, reduce allocation rate through code changes",
    "link": "https://XXXXXXX/#/?snapshotId=rjhkZXdNzegliVVEswMScGNn0YY",
    "zone": "prod",
    "fqdn": "host1.demo.com",
    "entity": "jvm",
    "entityLabel": "Test jvm",
    "tags": "production, documents, elasticsearch",
    "container": "test-container"
  }
}
 

{
  "issue": {
    "id": "53650436-8e35-49a3-a610-56b442ae7620",
    "type": "issue",
    "state": "CLOSED",
    "start": 1460537793322,
    "end": 1460538393322,
    "severity": 5,
    "text": "Garbage Collection Activity High (11%)",
    "suggestion": "Tune your Garbage Collector, reduce allocation rate through code changes",
    "link": "https://XXXXXXX/#/?snapshotId=rjhkZXdNzegliVVEswMScGNn0YY",
    "zone": "prod",
    "fqdn": "host1.demo.com",
    "entity": "jvm",
    "entityLabel": "Test jvm",
    "tags": "production, documents, elasticsearch",
    "container": "test-container"
  }
}
 

{
    "issue": {
        "id": "G9KRvijARFw6vffuygCvl_Fyg",
        "type": "change",
        "start": 1743798954000,
        "text": "Change detected",
        "description": "The value has changed from X to Y.\n",
        "link": "https://X/#/events;eventId=G9KRvijARFw6vffuygCvl_Fyg?&snapshotId=mTraati8sdfl0H5qrEagmIRIBYoM4",
        "end": 1743798954000,
        "zone": "prod",
        "fqdn": "something.com",
        "entity": "Kubernetes Pod",
        "entityLabel": "Test",
        "tags": "docs",
        "container": "b-container"
        }
    }
}
 

{
  "issue": {
    "id": "53650436-8e35-49a3-a610-56b442ae7620",
    "type": "presence",
    "start": 1460537793322,
    "text": "online",
    "description": "Java virtual machine on Host host1.demo.com",
    "link": "https://XXXXXXX/#/?snapshotId=rjhkZXdNzegliVVEswMScGNn0YY",
    "zone": "prod",
    "fqdn": "host1.demo.com",
    "entity": "jvm",
    "entityLabel": "Test jvm",
    "tags": "production, documents, elasticsearch",
    "container": "test-container"
  }
}
 

{
    "issue": {
        "id": "ah7cCh99TjGqnZJ4UL-uZHA",
        "type": "monitoringIssue",
        "state": "OPEN",
        "start": 1743798151988,
        "severity": 5,
        "text": "Monitoring issue: nodejs_collector_not_installed",
        "suggestion": "Our Agent observed a problem with monitoring the linked process.",
        "link": "https://XX/#/events;eventId=ah7cCh99TjGqnZJ4UL-uZHA?&snapshotId=UhgAKBptVGeu04DsagNGU",
        "zone": "ava",
        "fqdn": "cool.fyre.ibm.com",
        "entity": "Process",
        "entityLabel": "node  (7532267)",
        "tags": "proc",
        "container": "c-container"
    }
}
 

Certaines intégrations d' Webhook s nécessitent la définition d'en-têtes supplémentaires, qui peuvent être ajoutés dans cette section. Par exemple, l'ajout d'un jeton d'API pour AWS API Gateway.

Au lieu de saisir manuellement l'en-tête de requête « AuthorizationHTTP », vous pouvez utiliser l'authentification de base HTTP via le webhook URL. En ajoutant username et password au début du nom d'hôte, par exemple https://username:password@webhookurl.com, les informations d'identification sont automatiquement Base64-encoded et fournies sous la forme de la valeur d'en-tête HTTP suivante :

Authorization: Basic <base64 encoded credentials>
 

L'expression de transformation s'applique de manière globale au niveau du canal d'alerte et concerne toutes les alertes envoyées via ce canal. Tenez compte des instructions suivantes :

• Transformations spécifiques aux alertes : si vous avez besoin de transformations différentes pour différentes alertes, créez plusieurs canaux d'alerte Webhook, chacun avec sa propre expression de transformation.
• Gestion des erreurs : des expressions JSONata non valides peuvent entraîner des échecs dans la transmission des alertes. Assurez-vous que vos expressions sont valides et gérez correctement les valeurs nulles ou manquantes éventuelles en utilisant le bouton « Test Channel » avant de créer votre configuration.

JSONata est un langage de requête et de transformation simple des données JSON. Pour plus d'informations sur la syntaxe de JSONata, consultez la documentation de JSONata.

Pour créer un canal d'alerte Webhook avec transformation, incluez le champ transformationExpression facultatif dans votre requête API adressée au POST /api/events/settings/alertingChannels point de terminaison. Le transformationExpression champ doit respecter la syntaxe JSONata, comme le montre l'exemple suivant. Pour plus de détails sur l' API, consultez la page Instana OpenAPI.

{
    "transformationExpression": "{\"issue\": $merge([issue, {\"metricNames\": issue.text}])}",
    "headers": [],
    "rbacTags": [],
    "webhookUrls": [
        "https://webhook.example.com/endpoint"
    ],
    "kind": "WEB_HOOK",
    "name": "Transformed Webhook",
    "oauthEnabled": false
}
 

Les serveurs backend de l' Instana, émettent des requêtes à partir des serveurs AWS / Google Cloud. Il est donc important que les fichiers d' JavaScript s et de cartes sources soient généralement accessibles sur Internet. Veillez également à ce que votre backend dispose d'une configuration TLS opérationnelle avec une chaîne de certificats complète. Vous pouvez vérifier s'il existe des problèmes liés à l' TLS e en utilisant le test gratuit « SSL » proposé par SSL Labs/Qualys ou en exécutant la commande suivante :

openssl s_client -showcerts -connect {{YOUR_DOMAIN_HERE}}:443