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

일부 Webhook 연동 기능은 이 섹션에서 추가할 수 있는 헤더를 지정해야 합니다. 예를 들어, AWS API Gateway 에 API 토큰이 추가된 경우가 있습니다.

각 AuthorizationHTTP 요청 헤더를 수동으로 설정하는 대신, 웹훅 URL 을 통해 HTTP 기본 인증을 사용할 수 있습니다. 호스트명 앞에 및 password 을 username 붙여(예: https://username:password@webhookurl.com ) 인증 정보가 자동으로 Base64-encoded 처리되며, 다음과 같은 HTTP 헤더 값으로 제공됩니다:

Authorization: Basic <base64 encoded credentials>
 

변환 표현식은 알림 채널 수준에서 전역적으로 적용되며, 해당 채널을 통해 전송되는 모든 알림에 영향을 미칩니다. 다음 가이드라인에 유의하십시오.

• 경보별 변환 : 경보마다 서로 다른 변환이 필요한 경우, 각각 고유한 변환 표현식을 가진 여러 개의 웹훅 경보 채널을 생성하십시오.
• 오류 처리 : 유효하지 않은 JSONata 표현식은 알림 전송 실패를 유발할 수 있습니다. 구성을 생성하기 전에 ‘테스트 채널’ 버튼을 사용하여 표현식이 유효한지 확인하고, 잠재적인 null 값이나 누락된 값을 적절히 처리하십시오.

JSONata는 JSON 데이터에 대한 경량 조회 및 변환 언어입니다. JSONata 구문에 대한 자세한 내용은 JSONata 문서를 참조하십시오.

변환 기능을 포함한 웹훅 알림 채널을 생성하려면, 해당 POST /api/events/settings/alertingChannels 엔드포인트로 전송하는 API 요청에 선택적 transformationExpression 필드를 포함하십시오. 해당 transformationExpression 필드는 다음 예시와 같이 JSONata 구문을 따라야 합니다. API 에 대한 자세한 내용은 Instana OpenAPI specification을 참조하십시오.

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

Instana 의 백엔드에서 AWS 및 Google Cloud 서버로 요청을 전송하고 있습니다. 따라서, ` JavaScript ` 및 소스 맵 파일이 인터넷을 통해 누구나 쉽게 접근할 수 있도록 하는 것이 중요합니다. 또한, 백엔드에 인증서 체인이 완벽하게 구성된 정상 작동하는 TLS 설정이 있는지 확인하십시오. SSL Labs/Qualys에서 제공하는 무료 SSL 테스트를 이용하거나 다음 명령어를 실행하여 TLS 관련 문제를 확인할 수 있습니다:

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