Chuyển đến nội dung chính
Kết nối New Relic để CloudThinker chạy NRQL, kiểm tra golden metric và lỗi của một dịch vụ, đọc log và trace, và phân loại issue cùng alert condition đang mở. CloudThinker truy cập New Relic qua máy chủ New Relic MCP, xác thực bằng User API key (NRAK-...).

Điều kiện tiên quyết

  • Tài khoản New Relic ở region US hoặc EU.
  • Tính năng New Relic MCP Server được để bật cho organization của bạn. New Relic bật sẵn tính năng này, nhưng admin của organization có thể tắt trong feature control manager, và khi tính năng tắt thì không có gì hoạt động.
  • Một user New Relic thuộc group có hai loại role: một organization role đọc được máy chủ MCP, và một account role trên mỗi account agent cần truy vấn. Xem Quyền yêu cầu.
  • Quyền thêm kết nối trong workspace CloudThinker.
Máy chủ MCP của New Relic đang ở giai đoạn public preview, và New Relic không cho phép dùng với account thuộc diện FedRAMP hoặc HIPAA. Đừng kết nối các account đó.

Thiết lập

1

Tạo User API key

Mở API keys từ menu user trong New Relic, hoặc vào one.newrelic.com/api-keys (EU: one.eu.newrelic.com/api-keys). Nhấn Create a key, đặt Key type là User, đặt tên cloudthinker, rồi lưu.Sao chép toàn bộ key ngay. Key bắt đầu bằng NRAK- và New Relic chỉ hiện một lần.
2

Thêm kết nối

Trên thanh bên, nhấn More → Workspace settings → Connections, giữ nguyên tab Builtin Connections, rồi chọn New Relic. Điền:
  • Alias (tùy chọn): tên ngắn như newrelic-prod. Chữ thường, số và dấu gạch ngang.
  • Description (tùy chọn): đây là account hay môi trường nào. Agent đọc mô tả để chọn đúng instance.
  • NEWRELIC_API_KEY: key NRAK-.
  • NEWRELIC_REGION: US (mcp.newrelic.com) hoặc EU (mcp.eu.newrelic.com), khớp với nơi bạn đăng nhập.
Nhấn Connect. CloudThinker hiện Connecting và Verifying, rồi trạng thái Connected. Bước Verifying mở một phiên với máy chủ New Relic MCP của region bạn chọn và liệt kê công cụ của máy chủ. Bước này không chạy truy vấn nào, nên thiếu account role chỉ lộ ra sau, ở câu hỏi đầu tiên. Nếu xác minh lỗi, kết nối hiện Failed kèm thông báo lỗi. Đối chiếu thông báo với Khắc phục sự cố.
License key, ingest key và browser key không dùng được ở đây. Chỉ key loại User (NRAK-...) mới truy vấn được dữ liệu. Đây là lỗi thiết lập hay gặp nhất.

Chi tiết kết nối

Nếu bạn đăng nhập tại one.eu.newrelic.com, region của bạn là EU. Nếu không thì là US.

Quyền yêu cầu

User API key mang quyền của user sở hữu key. Không có scope riêng cho từng key, nên quyền tối thiểu đến từ user. User cần đủ cả hai cấp:
Tạo một user New Relic chuyên dụng và một group cho user đó. Trong Access management của New Relic, cấp cho group Organization Read Only ở cấp organization, rồi Read Only trên mỗi account bạn muốn điều tra. Tạo key dưới user đó. Loại user trong New Relic có thể ảnh hưởng tới chi phí, nên hãy kiểm tra user được gán loại nào.

Khả năng của agent

New Relic giữ một số công cụ AI, như NRQL bằng ngôn ngữ tự nhiên và báo cáo tác động deploy, chỉ cho đăng nhập OAuth. Đây là giới hạn của New Relic. User API key không dùng được các công cụ này, nên CloudThinker tự viết NRQL và đọc trực tiếp change event (xem Thay đổi ở trên). Khi kết nối lần đầu đạt Connected, CloudThinker chạy một lượt discovery chỉ đọc và lưu những gì tìm được cho các cuộc chat sau.

Xác minh kết nối

Câu trả lời bình thường nêu ít nhất một account ID cùng các event type của account đó, chẳng hạn Transaction hoặc Log.

Ví dụ prompt

Gửi cảnh báo New Relic tới Resolve

Resolve chưa có preset cho New Relic, nên bạn gửi thông báo workflow tới một custom signal source.
1

Tạo signal trong CloudThinker

Vào Resolve → Triggers & Outcomes, chọn Custom source và nhấn Add signal. Đặt tên New Relic, nhấn Create endpoint, rồi sao chép Webhook URL và secret key. Secret chỉ hiện một lần.
2

Thêm webhook destination trong New Relic

Trong New Relic, thêm một destination loại Webhook. Dán Webhook URL làm endpoint, và đặt xác thực bearer token bằng secret key, để New Relic gửi Authorization: Bearer <your-secret-key>.
3

Gửi thông báo tới destination từ một workflow

Trong workflow bao các alert policy bạn muốn, thêm một webhook notification tới destination đó. Giữ nguyên payload template mặc định của New Relic.
4

Gửi một sự kiện thử và ánh xạ các trường

Gửi một thông báo thử từ workflow. Khi CloudThinker hiện Payload received, nhấn Map the fields, chọn trường tiêu đề issue cho Incident title và trường priority cho Severity, rồi nhấn Save mapping. Các mức priority CRITICAL, HIGH, MEDIUM và LOW của New Relic được hiểu nguyên trạng.
Trạng thái thành công: issue tiếp theo từ workflow đó hiện trong Pulse, luồng cảnh báo trong Resolve, và agent điều tra issue qua kết nối này.

Khắc phục sự cố

  • Key bị thiếu, đã bị xóa, hoặc không phải User key. Kiểm tra key bắt đầu bằng NRAK-, tạo User key mới nếu cần, và cập nhật kết nối từ bảng chi tiết.
  • NEWRELIC_REGION không khớp với account. Nếu bạn đăng nhập tại one.eu.newrelic.com, chọn EU.
Tính năng New Relic MCP Server đang tắt cho organization của bạn. Tính năng này bật sẵn, nên một admin đã tắt nó trong feature control manager của New Relic. Nhờ họ bật lại, rồi kiểm tra lại kết nối.
User của key thiếu role đọc được máy chủ MCP, hoặc không có account role trên account đó. Cấp cho group của user Organization Read Only và Read Only trên account.
CloudThinker xác định entity theo tên trước khi truy vấn. Dùng đúng tên dịch vụ như trong New Relic, hoặc yêu cầu tìm entity theo tag.

Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
  • User chỉ đọc: User key không có scope riêng, nên hãy tạo key dưới user chỉ có role Organization Read Only và Read Only trên các account cần truy vấn.
  • Key chỉ hiện một lần: lưu key vào secrets manager ngay khi tạo. Nếu mất key, tạo key mới và xóa key cũ.

Liên quan

Custom Signal Source

Ghi nhận một sự kiện và ánh xạ các trường

Kết nối Datadog

Log, metric, monitor và trace