MetricFire MCP Server

ทางการ

ตรวจสอบโครงสร้างพื้นฐานของคุณด้วยภาษาธรรมชาติผ่าน MetricFire Model Context Protocol (MCP) Server ใหม่ เชื่อมต่อ MetricFire MCP Server เข้ากับผู้ช่วย AI เช่น GitHub Copilot และใช้คำสั่งง่ายๆ เพื่อค้นหาตัวชี้วัด แสดงข้อมูลเป็นภาพ สร้างการแจ้งเตือน และจัดการสภาพแวดล้อมการตรวจสอบของคุณ โดยไม่ต้องเขียน API calls

คุณทำอะไรได้บ้างด้วย MetricFire MCP?

  • Search metrics — Ask your assistant to find metrics by pattern or tags, including busy or invalid metrics.
  • Render Graphite data — Request metric data as JSON, CSV, raw, PNG, or SVG for a specified time range.
  • Manage alerts — Create, update, search, mute, or delete alerts, including composite alerts with AND/OR logic.
  • Build Grafana dashboards — Have your assistant create or update dashboards and panels from natural-language prompts.
  • Handle notification channels — Retrieve, create, update, or delete channels like Email, Slack, PagerDuty, and webhooks.
  • Schedule mutes — Set up recurring mute windows (e.g., weekends) and associate them with alerts.

เอกสาร

สำหรับดัชนีเอกสารฉบับสมบูรณ์ ดูที่ llms.txt เอกสารเวอร์ชัน Markdown มีให้ใช้งานโดยการต่อท้าย .md กับ URL ของหน้าเพจ หน้านี้มีให้ใช้งานเป็น Markdown

MF MCP Server

เชื่อมต่อผู้ช่วย AI เพื่อโต้ตอบกับ API ของ Hosted Graphite โดยใช้พรอมป์ภาษาธรรมชาติ

สารบัญ

{% embed url="https://www.youtube.com/watch?t=15s&v=7dIbd2rxARs" %}

MetricFire MCP Server ช่วยให้ไคลเอนต์ AI ที่รองรับสามารถโต้ตอบกับบัญชี Hosted Graphite ของคุณได้โดยตรงโดยใช้ Model Context Protocol (MCP)

เมื่อเชื่อมต่อแล้ว ไคลเอนต์ เช่น GitHub Copilot, Cursor, Claude/Claude Code และอื่น ๆ สามารถใช้ API ของ Hosted Graphite สำหรับการค้นหาเมตริก การเรนเดอร์ Graphite การจัดการการแจ้งเตือน ช่องทางการแจ้งเตือน การปิดเสียงตามกำหนดเวลา และเวิร์กโฟลว์การตรวจสอบอื่น ๆ

MCP server ทำงานกับข้อมูลและทรัพยากรในบัญชี Hosted Graphite ของคุณ เมตริกต้องถูกส่งต่อและจัดเก็บใน Hosted Graphite ก่อน จึงจะสามารถค้นหา เรนเดอร์ หรือใช้สำหรับการแจ้งเตือนได้

สร้าง MCP Token

ในบัญชี Hosted Graphite ของคุณ ไปที่ Add-Ons ⇒ MetricFire MCP Server

สร้าง token และเลือกสิทธิ์ที่จำเป็นสำหรับ MCP client ของคุณ:

  • อ่าน (Read) – เข้าถึงเมตริก การเรนเดอร์ การแจ้งเตือน ช่องทางการแจ้งเตือน การปิดเสียงตามกำหนดเวลา และทรัพยากรอื่น ๆ ที่รองรับ
  • เขียน (Write) – สร้างหรือแก้ไขทรัพยากรที่รองรับ
  • ลบ (Delete) – ลบทรัพยากรที่รองรับ

เราแนะนำให้ใช้สิทธิ์ขั้นต่ำที่จำเป็นสำหรับเวิร์กโฟลว์ของคุณ


MCP token แบบเต็มจะแสดงเพียงครั้งเดียวเมื่อสร้างเท่านั้น เก็บไว้อย่างปลอดภัยก่อนออกจากหน้าเพจ

เชื่อมต่อ MCP Client

จุดสิ้นสุด (endpoint) ของ Hosted Graphite MCP คือ:

https://mcp.hostedgraphite.com/

การกำหนดค่าจะแตกต่างกันเล็กน้อยขึ้นอยู่กับ MCP client

GitHub Copilot (VS Code)

เปิด Command Palette ใน VS Code และเลือก: MCP: Open User Configuration

เพิ่มออบเจกต์ MetricFire MCP Server:

{
  "servers": {
    "mf-mcp-server": {
      "url": "https://mcp.hostedgraphite.com/",
      "headers": {
        "X-HostedGraphite-MCP-Token": "YOUR-MCP-TOKEN"
      }
    }
  }
}

บันทึกการกำหนดค่า เริ่มต้น MCP server จากภายใน VS Code และโต้ตอบกับเอเจนต์โดยใช้ Copilot Chat

Cursor, Claude Code, Cline, Windsurf

ไคลเอนต์เหล่านี้รองรับ HTTP headers แบบกำหนดเอง กำหนดค่าจุดสิ้นสุด:

https://mcp.hostedgraphite.com/

และส่ง token ของคุณ:

X-HostedGraphite-MCP-Token: <MF-MCP-TOKEN>

อ้างอิงเอกสาร MCP ของไคลเอนต์ของคุณสำหรับตำแหน่งและรูปแบบของการกำหนดค่าเซิร์ฟเวอร์

Claude

การกำหนดค่าเบราว์เซอร์/UI ของ Claude สามารถเชื่อมต่อโดยใช้ MCP token ใน URL ของเซิร์ฟเวอร์:

https://<MF-MCP-TOKEN>@mcp.hostedgraphite.com

หมายเหตุ: เมื่อใช้การตรวจสอบสิทธิ์แบบ URL เราแนะนำอย่างยิ่งให้ใช้ token แบบอ่านอย่างเดียว เว้นแต่จำเป็นต้องใช้สิทธิ์เขียนหรือลบโดยเฉพาะ

เครื่องมือที่มีให้ใช้งาน

หลังจากเชื่อมต่อแล้ว MCP client ของคุณสามารถค้นพบเครื่องมือที่ Hosted Graphite เปิดเผยอยู่ในปัจจุบัน

เมตริก (Metrics)

มีเครื่องมือสำหรับ:

  • การค้นหาเมตริกมาตรฐาน (ตามรูปแบบ*)
  • การค้นหาเมตริกแบบติดแท็ก
  • เมตริกที่ไม่ว่าง (Busy metrics)
  • เมตริกที่ไม่ถูกต้อง
  • การลบเมตริก

Graphite Render

Graphite Render API สามารถสอบถามผ่าน MCP ได้ โดยรองรับ:

  • JSON
  • CSV
  • ข้อมูลดิบ
  • PNG
  • SVG

สิ่งนี้ช่วยให้ MCP clients ค้นหาเมตริกและดึงข้อมูลหรือแสดงภาพข้อมูลในช่วงเวลาที่กำหนด

การแจ้งเตือน (Alerts)

ผู้ช่วย AI สามารถทำงานกับเมตริก Hosted Graphite ของคุณเพื่อสร้าง การแจ้งเตือนแบบรวม (composite alerts) โดยใช้ตรรกะ AND/OR ทำให้ง่ายต่อการแจ้งเตือนเกี่ยวกับปัญหาระดับบริการแทนที่จะเป็นเกณฑ์ของเมตริกแต่ละรายการ

ตัวอย่างเช่น: "ค้นหาเมตริก CPU, หน่วยความจำ, ดิสก์ และเครือข่ายที่เกี่ยวข้องสำหรับเซิร์ฟเวอร์โปรดักชันของฉัน และสร้างการแจ้งเตือนแบบรวมที่ส่งอีเมลถึงฉันเมื่อมีสัญญาณหลายตัวบ่งชี้ถึงปัญหาระดับบริการ"

เครื่องมือการแจ้งเตือนรองรับ:

  • การสร้างและอัปเดตการแจ้งเตือน
  • การค้นหาและดึงข้อมูลการแจ้งเตือน
  • การลบการแจ้งเตือน
  • การปิดเสียงและเปิดเสียงการแจ้งเตือน
  • สถานะและประวัติการแจ้งเตือน
  • เกณฑ์การแจ้งเตือนแบบรวมโดยใช้ตรรกะ AND/OR

แดชบอร์ด (Dashboards)

ไคลเอนต์ AI สามารถอ้างอิงเมตริกที่จัดเก็บในบัญชี Hosted Graphite ของคุณและใช้เพื่อสร้าง อัปเดต และจัดการแดชบอร์ด Grafana โดยใช้พรอมป์ภาษาธรรมชาติ แทนที่จะค้นหาเมตริกด้วยตนเอง สร้างแผง และกำหนดค่าการแสดงผลทีละรายการ คุณสามารถขอให้ผู้ช่วย AI สร้างแดชบอร์ดรอบบริการ โฮสต์ แอปพลิเคชัน หรือส่วนประกอบโครงสร้างพื้นฐานที่คุณต้องการตรวจสอบ

ตัวอย่างเช่น: "ค้นหาเมตริก CPU, หน่วยความจำ, ดิสก์ และเครือข่ายที่เกี่ยวข้องสำหรับเซิร์ฟเวอร์โปรดักชันของฉัน และสร้างแดชบอร์ดภาพรวมโครงสร้างพื้นฐานที่ครอบคลุม"

เครื่องมือแดชบอร์ดรองรับ:

  • การสร้างแดชบอร์ด Grafana
  • การอัปเดตแดชบอร์ดที่มีอยู่
  • การค้นหาและดึงข้อมูลแดชบอร์ด
  • การลบแดชบอร์ด
  • การสร้างและกำหนดค่าแผงแดชบอร์ด
  • การใช้เมตริก Hosted Graphite เพื่อสร้างแดชบอร์ดจากพรอมป์ภาษาธรรมชาติ

{% embed url="https://www.youtube.com/watch?v=jzkK_87fi0Q" %}

ช่องทางการแจ้งเตือน (Notification Channels)

MCP clients สามารถทำงานกับช่องทางการแจ้งเตือนของ Hosted Graphite (Email, Slack, PagerDuty, MS Teams, webhooks และอื่น ๆ) รวมถึงการดึงข้อมูลช่องทางและเชื่อมโยงกับการแจ้งเตือน ขึ้นอยู่กับสิทธิ์ของ token ช่องทางที่รองรับสามารถสร้าง อัปเดต หรือลบได้

การปิดเสียงตามกำหนดเวลา (Scheduled Mutes)

เครื่องมือการปิดเสียงตามกำหนดเวลาช่วยให้ MCP clients สร้างและจัดการช่วงเวลาปิดเสียงที่เกิดซ้ำ (เช่น วันหยุดสุดสัปดาห์) การปิดเสียงตามกำหนดเวลาเป็นทรัพยากรแยกต่างหากที่สามารถเชื่อมโยงกับการแจ้งเตือนผ่าน Alert API

วิธีการทำงาน

MetricFire MCP Server ให้อินเทอร์เฟซ MCP กับ API ของ Hosted Graphite ที่รองรับ ไคลเอนต์ AI ที่เชื่อมต่อจะเลือกเครื่องมือ MCP ที่เหมาะสมตามคำขอและดำเนินการโดยใช้สิทธิ์ที่เกี่ยวข้องกับ MCP token ของคุณ

การผสานรวม MCP ไม่ได้แทนที่การเก็บรวบรวมเมตริกที่มีอยู่ของคุณ ดำเนินการส่งข้อมูลไปยัง Hosted Graphite ต่อไปโดยใช้เอเจนต์ การผสานรวม หรือโปรโตคอลที่รองรับที่มีอยู่ของคุณ

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ API พื้นฐาน ดูที่ เอกสาร API ของ Hosted Graphite และหากคุณต้องการความช่วยเหลือในการเชื่อมต่อ MCP client ติดต่อเราได้ที่: support@metricfire.com

MCP ยังไม่พร้อมใช้งานสำหรับผู้ใช้ที่เปิดใช้งาน Hosted Graphite Add-on จาก Heroku Marketplace ติดต่อเราเพื่อเรียนรู้วิธีโยกย้ายบัญชี Heroku HG ของคุณไปยังบัญชี HG เฉพาะและใช้ประโยชน์จากฟีเจอร์ทั้งหมดที่มี เช่น MCP และ Logging


คำแนะนำสำหรับเอเจนต์

เอกสารนี้เผยแพร่ด้วย GitBook GitBook เป็นแพลตฟอร์มเอกสารที่ออกแบบมาเพื่อให้ทั้งมนุษย์และเอเจนต์ AI สามารถอ่าน นำทาง และใช้เหตุผลกับเนื้อหาทางเทคนิคได้อย่างมีประสิทธิภาพ เรียนรู้เพิ่มเติมได้ที่ gitbook.com

การสอบถามเอกสารนี้

หากคุณต้องการข้อมูลเพิ่มเติมที่ไม่มีอยู่ในหน้านี้โดยตรง คุณสามารถสอบถามเอกสารได้โดยการถามคำถาม

ดำเนินการ HTTP GET request บน URL ต่อไปนี้ด้วยพารามิเตอร์ query ask และ goal:

GET https://docs.hostedgraphite.com/add-ons-and-integrations-guide/mf-mcp-server.md?ask=<question>&goal=<user_goal>

ask คือคำถามทันที: ควรเจาะจง เป็นอิสระในตัวเอง และเขียนเป็นภาษาธรรมชาติ goal คือสิ่งที่ผู้ใช้พยายามทำให้สำเร็จในท้ายที่สุด เหตุผลที่พวกเขาต้องการคำตอบ การแบ่งปันเป้าหมายช่วยให้ GitBook ให้คำตอบที่ดีและเกี่ยวข้องกับคุณมากขึ้น เป้าหมายมีประโยชน์มากที่สุดเมื่ออธิบายผลลัพธ์ที่ผู้ใช้ต้องการแทนที่จะกล่าวซ้ำคำถาม ตัวอย่างเช่น ด้วย ask=how do I create an API token เป้าหมายเช่น automate deployments from our CI pipeline ช่วยให้ GitBook ปรับแต่งคำตอบให้เหมาะกับกรณีการใช้งานนั้น

การตอบสนองจะประกอบด้วยคำตอบโดยตรงสำหรับคำถามและข้อความที่เกี่ยวข้องและแหล่งที่มาจากเอกสาร

ใช้กลไกนี้เมื่อคำตอบไม่ได้ปรากฏอย่างชัดเจนในหน้าปัจจุบัน คุณต้องการคำชี้แจงหรือบริบทเพิ่มเติม หรือคุณต้องการดึงส่วนเอกสารที่เกี่ยวข้อง