প্রকল্প সম্পর্কে

Grafana MCP সার্ভার একটি Model Context Protocol (MCP) সার্ভার, যা Claude Desktop বা Cursor-এর মতো MCP ক্লায়েন্টদের একটি Grafana ইনস্ট্যান্স এবং তার পারিপার্শ্বিক ইকোসিস্টেমের সাথে সংযুক্ত করে। সম্পূর্ণ কার্যকারিতার জন্য এটি Grafana 9.0 বা তার পরবর্তী সংস্করণ প্রয়োজন, কারণ কিছু ডেটাসোর্স অপারেশন নতুন API এন্ডপয়েন্টের উপর নির্ভর করে। সেটআপ করা হয় MCP ক্লায়েন্ট কনফিগারেশনে একটি এন্ট্রি যোগ করে, সাধারণত uvx-এর মাধ্যমে সার্ভার চালানো হয়, পরিবেশে GRAFANA_URL এবং একটি সার্ভিস অ্যাকাউন্ট টোকেন থাকে। Docker, বাইনারি এবং Helm ইনস্টলেশন অপশনও ডকুমেন্টেড আছে। সক্ষমতাগুলো টুল ক্যাটাগরিতে বিভক্ত, এবং টুল তালিকা কনফিগারযোগ্য, যাতে অব্যবহৃত কার্যকারিতা নিষ্ক্রিয় করে কনটেক্সট উইন্ডো স্পেস সাশ্রয় করা যায়। --disable-oncall বা --disable-navigation-এর মতো ফ্ল্যাগ দিয়ে ক্যাটাগরিগুলো বন্ধ করা যায়, এবং কয়েকটি ক্যাটাগরি ডিফল্টভাবে নিষ্ক্রিয় থাকে এবং --enabled-tools-এর মাধ্যমে সেগুলো চালু করতে হয়। ড্যাশবোর্ড টুলগুলো শিরোনাম, ফোল্ডার UID, ট্যাগ বা স্টারড স্ট্যাটাস দিয়ে অনুসন্ধান; UID বা সংরক্ষিত সংস্করণ দিয়ে ড্যাশবোর্ড আনা; সংস্করণ তালিকা; সংক্ষিপ্ত সারাংশ পাওয়া; JSONPath দিয়ে অংশ বের করা; ড্যাশবোর্ড তৈরি, আপডেট ও প্যাচ করা; এবং ডেটাসোর্স তথ্যসহ প্যানেল কোয়েরি পড়া কভার করে। README উল্লেখ করে যে সম্পূর্ণ ড্যাশবোর্ড JSON উল্লেখযোগ্য কনটেক্সট উইন্ডো স্পেস নিতে পারে এবং পরিবর্তে সারাংশ বা JSONPath টুল ব্যবহারের পরামর্শ দেয়। ডেটাসোর্স ও কোয়েরি সাপোর্টের মধ্যে রয়েছে ডেটাসোর্স তালিকা ও পরিদর্শন (Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake, Athena), PromQL ইনস্ট্যান্ট ও রেঞ্জ কোয়েরি এবং মেট্রিক মেটাডেটা ও হিস্টোগ্রাম পার্সেন্টাইল, লেবেল ও প্যাটার্ন ডিসকভারিসহ LogQL লগ ও মেট্রিক কোয়েরি, InfluxQL বা Flux-এর মাধ্যমে InfluxDB, ম্যাক্রো প্রতিস্থাপন ও লিমিট প্রয়োগসহ ClickHouse, Snowflake, Athena, MySQL, PostgreSQL ও MSSQL-এর জন্য ইউনিফাইড SQL টুল, CloudWatch নেমস্পেস, মেট্রিক ও ডাইমেনশন, Graphite রেন্ডার কোয়েরি ও মেট্রিক ডিসকভারি, Elasticsearch/OpenSearch ও Quickwit অনুসন্ধান, এবং উদাহরণ কোয়েরি পুনরুদ্ধার। SQL কোয়েরি Grafana ডেটাসোর্স প্লাগইনের মাধ্যমে চলে, তাই ক্রেডেনশিয়াল MCP সার্ভারের বদলে ডেটাসোর্স কনফিগারেশন দ্বারা পরিচালিত হয়। অপারেশনাল ক্ষেত্রগুলোর মধ্যে রয়েছে অ্যালার্টিং (নিয়ম তালিকা, তৈরি, আপডেট, মুছে ফেলা; নোটিফিকেশন পলিসি, কন্টাক্ট পয়েন্ট, টাইম ইন্টারভাল), Grafana Incident (অনুসন্ধান, তৈরি, আপডেট, কাস্টম ফিল্ড), Sift ইনভেস্টিগেশন (তালিকা, বিস্তারিত, বিশ্লেষণ, এরর প্যাটার্ন ও স্লো রিকোয়েস্ট সনাক্তকরণ), Grafana OnCall (শিডিউল, শিফট, বর্তমান অন-কল ব্যবহারকারী, টিম, ব্যবহারকারী, অ্যালার্ট গ্রুপ), অ্যানোটেশন (কোয়েরি, তৈরি, আপডেট, প্যাচ, মুছে ফেলা, ট্যাগ), স্ন্যাপশট (তালিকা, পাওয়া, তৈরি, মুছে ফেলা), Grafana Image Renderer-এর মাধ্যমে প্যানেল বা ড্যাশবোর্ড PNG হিসেবে রেন্ডারিং, প্রভিশনিং রিপোজিটরি তালিকা ও ড্রাই-রান ভ্যালিডেশন, ড্যাশবোর্ড, প্যানেল ও Explore-এর জন্য ডিপলিংক জেনারেশন, এবং মাল্টি-অর্গানাইজেশন রিকোয়েস্টের জন্য ব্যবহারকারী পরিচয় অনুসন্ধান। Grafana Cloud-শুধুমাত্র Agent Observability টুলগুলো LLM কথোপকথন তালিকা ও অনুসন্ধান, মূল্যায়ন স্কোরসহ কথোপকথন ও জেনারেশন বিস্তারিত, সংস্করণ ইতিহাস ও টোকেন অনুমানসহ একটি এজেন্ট ক্যাটালগ, মূল্যায়নকারী ও টেমপ্লেট, ইভাল নিয়ম ও গার্ড, সংরক্ষিত কথোপকথন ও সংগ্রহ, টেস্ট স্যুট, এবং অফলাইন পরীক্ষা কভার করে। এর কয়েকটিতে একটি নির্দিষ্ট অনুমতির পিছনে থাকা রাইট অপারেশন রয়েছে। Grafana Assistant টুলগুলো অ্যাসিস্ট্যান্টের কাছে প্রাকৃতিক ভাষার প্রম্পট পাঠায় এবং ফেরত দেওয়া কনটেক্সট ID-এর মাধ্যমে কথোপকথন চালিয়ে যাওয়া সমর্থন করে; এগুলো রাইট টুল এবং --disable-write সেট থাকলে এড়িয়ে যাওয়া হয়। অ্যাক্সেস নিয়ন্ত্রণ RBAC-ভিত্তিক: প্রতিটি টুলের নির্দিষ্ট অনুমতি ও স্কোপ প্রয়োজন, এবং README প্রয়োজনীয় গ্রান্টসহ একটি সার্ভিস অ্যাকাউন্ট তৈরির পরামর্শ দেয়, উল্লেখ করে যে বিল্ট-ইন Editor রোল একটি সরল কিন্তু কম গ্রানুলার বিকল্প। Incident ও Sift টুলগুলো সূক্ষ্ম-দানাদার অনুমতির বদলে বেসিক Viewer/Editor রোল ব্যবহার করে। README-তে একটি টুল টেবিল রয়েছে যা টুল নামগুলোকে ক্যাটাগরি, প্রয়োজনীয় RBAC অনুমতি এবং প্রয়োজনীয় স্কোপের সাথে ম্যাপ করে।