> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tích hợp Webhook Incident

> Kết nối nền tảng cảnh báo của bạn để tự động tạo incident với điều tra được hỗ trợ bởi AI

CloudThinker tích hợp với các nền tảng cảnh báo và giám sát bao gồm PagerDuty, Datadog, Grafana và nhiều hơn nữa. Mỗi tích hợp bao gồm field mapping theo nền tảng, xác thực linh hoạt và kích hoạt điều tra AI tự động.

***

## Nền tảng được hỗ trợ

### Quản lý incident

<CardGroup cols={2}>
  <Card title="PagerDuty" icon="https://mintcdn.com/cloudthinker/NZTEnySYVy068g6u/images/icons/integrations/pagerduty-icon.svg?fit=max&auto=format&n=NZTEnySYVy068g6u&q=85&s=7e1bb7c9ae2e6aa13608c8d4d48811cf" href="/vi/guide/connections/pagerduty" width="64" height="64" data-path="images/icons/integrations/pagerduty-icon.svg">
    Xác thực: HMAC-SHA256

    Quản lý on-call và phản hồi incident với field mapping gốc cho các sự kiện triggered, acknowledged và resolved.
  </Card>

  <Card title="ServiceNow" icon="https://mintcdn.com/cloudthinker/NZTEnySYVy068g6u/images/icons/integrations/service-now.svg?fit=max&auto=format&n=NZTEnySYVy068g6u&q=85&s=0732f3ddc9a9af6f7c3325a74c7aa30a" href="/vi/guide/connections/servicenow" width="71" height="64" data-path="images/icons/integrations/service-now.svg">
    Xác thực: API Key

    Quản lý dịch vụ IT doanh nghiệp với CMDB CI mapping để cung cấp ngữ cảnh hạ tầng.
  </Card>
</CardGroup>

| Nền tảng     | Ghi chú                                                                                           |
| ------------ | ------------------------------------------------------------------------------------------------- |
| **Opsgenie** | Xác thực: API Key. Quản lý cảnh báo của Atlassian với priority mapping và dữ liệu phân công nhóm. |
| **BigPanda** | Xác thực: Bearer Token. AIOps event correlation và quản lý cảnh báo với nhóm cảnh báo thông minh. |

### Giám sát & quan sát

<CardGroup cols={2}>
  <Card title="Datadog" icon="https://mintcdn.com/cloudthinker/ezLyBgfIZEMSknyR/images/icons/integrations/datadog-icon.svg?fit=max&auto=format&n=ezLyBgfIZEMSknyR&q=85&s=3548a1b2e3bc616d2d37d439eba151c6" href="/vi/guide/connections/datadog" width="64" height="64" data-path="images/icons/integrations/datadog-icon.svg">
    Xác thực: Bearer Token

    Giám sát toàn stack với số liệu, cảnh báo và tương quan dịch vụ dựa trên thẻ.
  </Card>

  <Card title="Grafana" icon="https://mintcdn.com/cloudthinker/NZTEnySYVy068g6u/images/icons/integrations/grafana-logo.svg?fit=max&auto=format&n=NZTEnySYVy068g6u&q=85&s=e0a907966b1ad4ff181ef93cb411e373" href="/vi/guide/connections/grafana" width="800" height="800" data-path="images/icons/integrations/grafana-logo.svg">
    Xác thực: Bearer Token

    Thông báo cảnh báo với liên kết dashboard, ngữ cảnh panel và trích xuất common label.
  </Card>

  <Card title="Prometheus / Alertmanager" icon="https://mintcdn.com/cloudthinker/NZTEnySYVy068g6u/images/icons/integrations/prometheus-logo.svg?fit=max&auto=format&n=NZTEnySYVy068g6u&q=85&s=116d0e24c961b3e19e141d98a61ae3b8" href="/vi/guide/connections/prometheus" width="64" height="64" data-path="images/icons/integrations/prometheus-logo.svg">
    Xác thực: Bearer Token

    Webhook receiver gốc của Alertmanager với trích xuất label, hỗ trợ nhóm và metadata Kubernetes.
  </Card>
</CardGroup>

| Nền tảng   | Ghi chú                                                                                     |
| ---------- | ------------------------------------------------------------------------------------------- |
| **Splunk** | Xác thực: Bearer Token. Cảnh báo tìm kiếm đã lưu với ngữ cảnh kết quả và liên kết tìm kiếm. |

### Cảnh báo nhà cung cấp cloud

<CardGroup cols={2}>
  <Card title="AWS CloudWatch" icon="https://mintcdn.com/cloudthinker/ezLyBgfIZEMSknyR/images/icons/integrations/aws-cloudwatch.svg?fit=max&auto=format&n=ezLyBgfIZEMSknyR&q=85&s=9539b73889491ac68c768dc601c6276d" href="/vi/guide/incident/webhook-integrations/cloudwatch" width="16" height="16" data-path="images/icons/integrations/aws-cloudwatch.svg">
    Xác thực: API Key

    Cảnh báo dựa trên EventBridge với trạng thái alarm, dữ liệu số liệu và ngữ cảnh namespace.
  </Card>
</CardGroup>

| Nền tảng           | Ghi chú                                                                                        |
| ------------------ | ---------------------------------------------------------------------------------------------- |
| **Azure Monitor**  | Xác thực: Không. Hỗ trợ Common Alert Schema với ngữ cảnh tài nguyên và severity mapping.       |
| **GCP Monitoring** | Xác thực: Bearer Token. Thông báo incident với chi tiết chính sách và tên hiển thị tài nguyên. |

### APM & theo dõi lỗi

<CardGroup cols={2}>
  <Card title="New Relic" icon="https://mintcdn.com/cloudthinker/NZTEnySYVy068g6u/images/icons/integrations/new-relic.svg?fit=max&auto=format&n=NZTEnySYVy068g6u&q=85&s=f302e6dc3976df413a0ebe8fa92da32d" href="/vi/guide/connections/newrelic" width="2500" height="2031" data-path="images/icons/integrations/new-relic.svg">
    Xác thực: API Key

    Quan sát toàn stack với mức độ ưu tiên issue và ngữ cảnh entity.
  </Card>

  <Card title="Dynatrace" icon="https://mintcdn.com/cloudthinker/ezLyBgfIZEMSknyR/images/icons/integrations/dynatrace.svg?fit=max&auto=format&n=ezLyBgfIZEMSknyR&q=85&s=d1c94ab707135fdc0bd47de611b56760" href="/vi/guide/connections/dynatrace" width="64" height="64" data-path="images/icons/integrations/dynatrace.svg">
    Xác thực: API Key

    Thông minh phần mềm với phân tích tác động vấn đề và nguyên nhân gốc rễ do AI phát hiện.
  </Card>
</CardGroup>

| Nền tảng   | Ghi chú                                                                                           |
| ---------- | ------------------------------------------------------------------------------------------------- |
| **Sentry** | Xác thực: HMAC-SHA256. Theo dõi lỗi ứng dụng với chi tiết issue, stack trace và ngữ cảnh project. |

### Tích hợp tùy chỉnh

| Nền tảng            | Ghi chú                                                                                                                                             |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Generic Webhook** | Xác thực: Bearer Token (có thể cấu hình). Webhook hoàn toàn tùy chỉnh cho bất kỳ nền tảng nào. Tự định nghĩa field mapping bằng biểu thức JSONPath. |

> **Lộ trình nền tảng:** Không thấy nền tảng của bạn? Dùng Generic Webhook để tích hợp ngay lập tức, hoặc liên hệ hỗ trợ để yêu cầu connector gốc cho công cụ giám sát của bạn.

***

## Thiết lập tích hợp webhook

Trình hướng dẫn thiết lập sẽ dẫn bạn qua lựa chọn nền tảng, cấu hình webhook và cài đặt phân tích nguyên nhân gốc rễ tự động.

<Frame>
  <img src="https://mintcdn.com/cloudthinker/EgdXomufF-sGaM1E/images/incidents/setup/01-setup-wizard-home.jpg?fit=max&auto=format&n=EgdXomufF-sGaM1E&q=85&s=f0a672ba2519f4bba831fe3a6f6846cc" alt="Trang chủ trình hướng dẫn thiết lập Deep Response Engine với tổng quan phân tích nguyên nhân gốc rễ được hỗ trợ bởi AI" width="3588" height="2004" data-path="images/incidents/setup/01-setup-wizard-home.jpg" />
</Frame>

<p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>Dashboard Deep Response Engine với điểm vào trình hướng dẫn thiết lập</p>

<Steps>
  <Step title="Điều hướng đến Integrations">
    Vào **Deep Response Engine** → **Settings** → tab **Integrations** để truy cập quản lý webhook.
  </Step>

  <Step title="Tạo Webhook">
    Nhấp **Connect** trên card nền tảng của bạn. Trình tạo sẽ mở với các giá trị mặc định theo nền tảng đã được cài đặt sẵn.

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/EgdXomufF-sGaM1E/images/incidents/setup/02-select-platform-modal.jpg?fit=max&auto=format&n=EgdXomufF-sGaM1E&q=85&s=813d162c00c7cadd5c302b37323070d4" alt="Modal chọn nền tảng hiển thị các tùy chọn nền tảng giám sát và cảnh báo bao gồm PagerDuty, Datadog, Grafana và AWS CloudWatch" width="2094" height="1688" data-path="images/incidents/setup/02-select-platform-modal.jpg" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>Chọn nền tảng giám sát từ các tùy chọn có sẵn</p>
  </Step>

  <Step title="Cấu hình thông tin cơ bản">
    Nhập tên và mô tả tùy chọn cho webhook của bạn. Đặt giới hạn tốc độ nếu cần (mặc định: 100 yêu cầu mỗi giờ).
  </Step>

  <Step title="Xem lại Field Mapping">
    Mỗi nền tảng có sẵn JSONPath mapping được cấu hình sẵn để trích xuất các trường incident từ payload webhook của bạn. Tùy chỉnh nếu cần:

    | Trường Incident | JSONPath ví dụ              | Mô tả                             |
    | --------------- | --------------------------- | --------------------------------- |
    | Title           | `$.event.data.title`        | Tiêu đề incident                  |
    | Description     | `$.event.data.description`  | Thông tin chi tiết                |
    | Severity        | `$.event.data.priority`     | Critical, High, Medium, Low, Info |
    | Services        | `$.event.data.service.name` | Tên dịch vụ bị ảnh hưởng          |

    Bạn cũng có thể cấu hình **severity mapping** để chuyển đổi giá trị severity của nền tảng (ví dụ: `warning` → `medium`, `P1` → `critical`) sang mức severity của CloudThinker.

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/mbO-yJISTs683mos/images/incidents/setup/03-configure-webhook-fields.jpg?fit=max&auto=format&n=mbO-yJISTs683mos&q=85&s=3e2e78c9906b973c08090898d794a9ed" alt="Form cấu hình webhook hiển thị field mapping với các biểu thức JSONPath cho Title Path, Severity Path, Description Path và Services Path" width="3586" height="2056" data-path="images/incidents/setup/03-configure-webhook-fields.jpg" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>Cấu hình JSONPath field mapping cho payload webhook của bạn</p>
  </Step>

  <Step title="Cấu hình cài đặt Auto-Trigger">
    Kiểm soát cách incident kích hoạt [Phân tích Nguyên nhân Gốc rễ](/vi/guide/incident/root-cause-analysis):

    * **Auto-trigger RCA:** Tự động bắt đầu điều tra AI khi incident được tạo
    * **Minimum severity:** Chỉ kích hoạt RCA cho incident ở mức severity này hoặc cao hơn (mặc định: Medium)
    * **Send all fields to agent:** Chuyển tiếp toàn bộ payload webhook đến tác nhân RCA để phân tích phong phú hơn

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/mbO-yJISTs683mos/images/incidents/setup/05-configure-rca-settings.jpg?fit=max&auto=format&n=mbO-yJISTs683mos&q=85&s=48fa14186831df2d79a32729005df187" alt="Panel cấu hình Root Cause Analysis với nút bật Auto-trigger RCA, dropdown Minimum Severity đặt thành Medium" width="3586" height="2056" data-path="images/incidents/setup/05-configure-rca-settings.jpg" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>Cấu hình kích hoạt RCA tự động và ngưỡng severity</p>
  </Step>

  <Step title="Sao chép URL Webhook & Xác thực">
    Tab **Setup** hiển thị URL webhook và chi tiết xác thực của bạn. Sao chép các thông tin xác thực này và cấu hình trong nền tảng cảnh báo của bạn.

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/mbO-yJISTs683mos/images/incidents/setup/04-webhook-url-code-examples.jpg?fit=max&auto=format&n=mbO-yJISTs683mos&q=85&s=7bfb126e216a2bddff0c6de499e3fdda" alt="Tab Setup hiển thị URL webhook, định dạng yêu cầu, HTTP header và ví dụ code cho tích hợp webhook" width="3586" height="2056" data-path="images/incidents/setup/04-webhook-url-code-examples.jpg" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>Sao chép URL webhook và header xác thực để cấu hình trong nền tảng cảnh báo của bạn</p>
  </Step>
</Steps>

***

## Phương thức xác thực

CloudThinker hỗ trợ bốn phương thức xác thực phù hợp với yêu cầu của nền tảng. Phương thức chính xác được chọn sẵn khi bạn chọn nền tảng, nhưng bạn có thể thay đổi cho tích hợp tùy chỉnh.

| Phương thức           | Cách hoạt động                                                                                  | Được dùng bởi                                                  |
| --------------------- | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| **Bearer Token**      | Xác thực dựa trên token tiêu chuẩn qua header `Authorization`                                   | Datadog, Grafana, Prometheus, Splunk, GCP Monitoring, BigPanda |
| **HMAC-SHA256**       | Xác minh chữ ký mật mã — CloudThinker xác thực chữ ký nội dung yêu cầu bằng khóa bí mật chia sẻ | PagerDuty, Sentry                                              |
| **API Key**           | Header tùy chỉnh với tiền tố tùy chọn (ví dụ: `GenieKey`, `Api-Token`)                          | Opsgenie, New Relic, Dynatrace, ServiceNow, AWS CloudWatch     |
| **No Authentication** | Dành cho nền tảng xác minh danh tính qua cơ chế khác                                            | Azure Monitor                                                  |

<Note>
  Khi bạn thay đổi phương thức xác thực trên webhook hiện có, các tích hợp hiện tại dùng phương thức cũ sẽ ngừng hoạt động ngay lập tức. Hãy tạo lại thông tin xác thực sau khi thay đổi phương thức xác thực.
</Note>

***

## Tương quan cảnh báo

Khi nhiều cảnh báo đến trong một khoảng thời gian ngắn, CloudThinker có thể tự động tương quan chúng thành một incident duy nhất thay vì tạo bản sao. Điều này giảm mệt mỏi cảnh báo từ các lỗi cascade.

### Tương quan cửa sổ thời gian

Nhóm các cảnh báo nhận được trong cửa sổ có thể cấu hình (mặc định: 5 phút). Khi một cảnh báo mới khớp với một incident đang mở, nó được gắn là cảnh báo tương quan thay vì tạo incident mới.

### Tương quan dựa trên quy tắc

Định nghĩa các quy tắc tùy chỉnh để khớp cảnh báo đến với incident hiện có dựa trên các thuộc tính chung. Quy tắc được cấu hình từ menu card webhook trong **Correlation Rules**.

Mỗi quy tắc chỉ định:

* **Điều kiện** với logic AND/OR để khớp
* **Mức độ ưu tiên** (0–1000) để kiểm soát thứ tự đánh giá
* **Trọng số** (0.0–1.0) để chỉ ra độ tin cậy khớp
* Ngưỡng **trọng số khớp tối thiểu** để chấp nhận tương quan

**Toán tử có sẵn:**

| Toán tử                     | Mô tả                                    |
| --------------------------- | ---------------------------------------- |
| `equals` / `not_equals`     | Khớp chính xác hoặc không khớp           |
| `contains` / `not_contains` | Khớp chuỗi con                           |
| `starts_with` / `ends_with` | Khớp tiền tố hoặc hậu tố                 |
| `regex`                     | Khớp biểu thức chính quy                 |
| `in` / `not_in`             | Giá trị có hoặc không có trong danh sách |
| `intersects`                | Giao nhau mảng (ví dụ: thẻ chung)        |
| `exists`                    | Trường có mặt                            |

***

## Bảo mật & giới hạn

### Giới hạn payload

| Giới hạn                          | Giá trị      |
| --------------------------------- | ------------ |
| Kích thước body HTTP tối đa       | 1 MB         |
| Kích thước payload lưu trữ tối đa | 100 KB       |
| Độ dài trường tối đa              | 10.000 ký tự |
| Số phần tử mảng tối đa            | 100 phần tử  |
| Độ sâu lồng tối đa                | 10 cấp       |

### Giới hạn tốc độ

| Giới hạn                 | Giá trị                         |
| ------------------------ | ------------------------------- |
| Giới hạn tốc độ mặc định | 100 yêu cầu mỗi giờ mỗi webhook |
| Giới hạn lỗi xác thực    | 10 lỗi trong cửa sổ 15 phút     |
| Phản hồi khi vượt quá    | HTTP 429                        |

Giới hạn tốc độ có thể cấu hình theo từng webhook. Đặt thành 0 để không giới hạn.

### Tính năng bảo mật

* **Xác minh chữ ký an toàn về thời gian** ngăn chặn tấn công timing trên HMAC validation
* **Lưu trữ khóa bí mật được mã hóa** — các khóa bí mật webhook được mã hóa khi lưu trữ
* **Xoay thông tin xác thực** — tạo lại token và khóa bí mật webhook mà không cần tạo lại webhook
* **Làm sạch payload** — các trường quá lớn được tự động cắt ngắn
* **Lọc header nhạy cảm** — header xác thực bị loại khỏi nhật ký kiểm tra

***

## Liên quan

<CardGroup cols={2}>
  <Card title="AWS CloudWatch" icon="https://mintcdn.com/cloudthinker/ezLyBgfIZEMSknyR/images/icons/integrations/aws-cloudwatch.svg?fit=max&auto=format&n=ezLyBgfIZEMSknyR&q=85&s=9539b73889491ac68c768dc601c6276d" href="/vi/guide/incident/webhook-integrations/cloudwatch" width="16" height="16" data-path="images/icons/integrations/aws-cloudwatch.svg">
    Hướng dẫn từng bước để định tuyến CloudWatch alarm qua Amazon EventBridge.
  </Card>

  <Card title="Root cause analysis" icon="magnifying-glass" href="/vi/guide/incident/root-cause-analysis">
    Cấu hình điều tra tự động được hỗ trợ bởi AI được kích hoạt bởi webhook đến.
  </Card>
</CardGroup>
