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.
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.
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: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
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.Khắc phục sự cố
Lỗi ở bước Verifying hoặc ở mọi lệnh gọi, dù key hợp lệ
Lỗi ở bước Verifying hoặc ở mọi lệnh gọi, dù key hợp lệ
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.
Lỗi quyền hoặc thiếu account
Lỗi quyền hoặc thiếu account
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.
Không tìm thấy entity hoặc dịch vụ
Không tìm thấy entity hoặc dịch vụ
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