@dynatrace-oss/dynatrace-mcp-server 0.7.0 → 0.8.0

package/README.md

@@ -25,6 +25,8 @@ bringing real-time observability data directly into your development workflow.
 
 If you need help, please contact us via [GitHub Issues](https://github.com/dynatrace-oss/dynatrace-mcp/issues) if you have feature requests, questions, or need help.
 
+https://github.com/user-attachments/assets/25c05db1-8e09-4a7f-add2-ed486ffd4b5a
+
 ## Quickstart
 
 You can add this MCP server to your MCP Client like VSCode, Claude, Cursor, Amazon Q, Windsurf, ChatGPT, or Github Copilot via the npmjs package `@dynatrace-oss/dynatrace-mcp-server`, and type `stdio`.

package/dist/authentication/dynatrace-clients.js

@@ -34,7 +34,7 @@ const requestToken = async (clientId, clientSecret, ssoAuthUrl, scopes) => {
     return await res.json();
 };
 /**
- * Create a Dynatrace Http Client (from the http-client SDK) based on the provided authentication credentails
+ * Create a Dynatrace Http Client (from the http-client SDK) based on the provided authentication credentials
  * @param environmentUrl
  * @param scopes
  * @param clientId

package/dist/capabilities/get-events-for-cluster.js

@@ -2,12 +2,22 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEventsForCluster = void 0;
 const execute_dql_1 = require("./execute-dql");
-const getEventsForCluster = async (dtClient, clusterId) => {
-    let dql = `fetch events | filter k8s.cluster.uid == "${clusterId}"`;
-    if (!clusterId) {
-        // if no clusterId is provided, we need to fetch all events
-        dql = `fetch events | filter isNotNull(k8s.cluster.uid)`;
+const getEventsForCluster = async (dtClient, clusterId, kubernetesEntityId, eventType) => {
+    let dql = 'fetch events';
+    if (!clusterId && !kubernetesEntityId) {
+        // If no clusterId or kubernetesEntityId is provided, return all kubernetes related events
+        dql += ` | filter isNotNull(k8s.cluster.uid)`;
     }
+    else if (clusterId || kubernetesEntityId) {
+        // filter by clusterId or kubernetesEntityId if provided
+        dql += `| filter k8s.cluster.uid == "${clusterId}" or dt.entity.kubernetes_cluster == "${kubernetesEntityId}"`;
+    }
+    // filter by eventType if provided
+    if (eventType) {
+        dql += ` | filter eventType == "${eventType}"`;
+    }
+    // sort by timestamp
+    dql += ' | sort timestamp desc';
     return (0, execute_dql_1.executeDql)(dtClient, { query: dql });
 };
 exports.getEventsForCluster = getEventsForCluster;

package/dist/capabilities/update-workflow.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateWorkflow = void 0;
 const client_automation_1 = require("@dynatrace-sdk/client-automation");
 const updateWorkflow = async (dtClient, workflowId, body) => {
-    const workflowsclient = new client_automation_1.WorkflowsClient(dtClient);
-    return await workflowsclient.updateWorkflow({
+    const workflowsClient = new client_automation_1.WorkflowsClient(dtClient);
+    return await workflowsClient.updateWorkflow({
         id: workflowId,
         body: body,
     });

package/dist/index.js

@@ -321,7 +321,7 @@ const main = async () => {
             return 'No problems found';
         }
     });
-    tool('find_entity_by_name', 'Find the entityId and type of a monitored entity (service, host, process-group, application, kubernetes-node, custom-app, ...) within the topology on Dynatrace, based on the name of the entity. Run this before querying data like logs, metrics, problems, events. If no entity name is known, make an educated guess with common identifiers like package.json `id`/`name`, helm chart names, kubernetes manfiest names, and alike.', {
+    tool('find_entity_by_name', 'Find the entityId and type of a monitored entity (service, host, process-group, application, kubernetes-node, custom-app, ...) within the topology on Dynatrace, based on the name of the entity. Run this before querying data like logs, metrics, problems, events. If no entity name is known, make an educated guess with common identifiers like package.json `id`/`name`, helm chart names, kubernetes manifest names, and alike.', {
         entityNames: zod_1.z
             .array(zod_1.z.string())
             .describe('Names of the entities to search for - try with one name at first (identifiers like package.json id), and only try with multiple names if the first search was unsuccessful'),
@@ -637,13 +637,50 @@ const main = async () => {
         clusterId: zod_1.z
             .string()
             .optional()
-            .describe(`The Kubernetes (K8s) Cluster Id, referred to as k8s.cluster.uid (this is NOT the Dynatrace environment)`),
+            .describe(`The Kubernetes Cluster Id, referred to as k8s.cluster.uid, usually seen when using "kubectl" - this is NOT the Dynatrace environment and not the Dynatrace Kubernetes Entity Id. Leave empty if you don't know the Cluster Id.`),
+        kubernetesEntityId: zod_1.z
+            .string()
+            .optional()
+            .describe(`The Dynatrace Kubernetes Entity Id, referred to as dt.entity.kubernetes_cluster. Leave empty if you don't know the Entity Id, or use the "find_entity_by_name" tool to find the cluster by name.`),
+        eventType: zod_1.z
+            .enum([
+            'OMPLIANCE_FINDING',
+            'COMPLIANCE_SCAN_COMPLETED',
+            'CUSTOM_INFO',
+            'DETECTION_FINDING',
+            'ERROR_EVENT',
+            'OSI_UNEXPECTEDLY_UNAVAILABLE',
+            'PROCESS_RESTART',
+            'RESOURCE_CONTENTION_EVENT',
+            'SERVICE_CLIENT_ERROR_RATE_INCREASED',
+            'SERVICE_CLIENT_SLOWDOWN',
+            'SERVICE_ERROR_RATE_INCREASED',
+            'SERVICE_SLOWDOWN',
+            'SERVICE_UNEXPECTED_HIGH_LOAD',
+            'SERVICE_UNEXPECTED_LOW_LOAD',
+        ])
+            .optional(),
+        maxEventsToDisplay: zod_1.z.number().default(10).describe('Maximum number of events to display in the response.'),
     }, {
         readOnlyHint: true,
-    }, async ({ clusterId }) => {
+    }, async ({ clusterId, kubernetesEntityId, eventType, maxEventsToDisplay }) => {
         const dtClient = await (0, dynatrace_clients_1.createDtHttpClient)(dtEnvironment, scopesBase.concat('storage:events:read'), oauthClientId, oauthClientSecret, dtPlatformToken);
-        const events = await (0, get_events_for_cluster_1.getEventsForCluster)(dtClient, clusterId);
-        return `Kubernetes Events:\n${JSON.stringify(events)}`;
+        const result = await (0, get_events_for_cluster_1.getEventsForCluster)(dtClient, clusterId, kubernetesEntityId, eventType);
+        if (result && result.records && result.records.length > 0) {
+            let resp = `Found ${result.records.length} events! Displaying the top ${maxEventsToDisplay} events:\n`;
+            // iterate over dqlResponse and create a string with the problem details, but only show the top maxEntitiesToDisplay problems
+            result.records.slice(0, maxEventsToDisplay).forEach((event) => {
+                if (event) {
+                    resp += `- Event ${event['event.id']} (${event['event.type']}) on Kubernetes Entity ID ${event['dt.entity.kubernetes_cluster']} with status ${event['event.status']}: ${event['event.name']} - started at ${event['event.start']}, ended at ${event['event.end']}, duration: ${event['duration']}\n`;
+                }
+            });
+            resp +=
+                `\nNext Steps:` +
+                    `\n1. Consider filtering by \`eventType\` to find specific events of interest.` +
+                    `\n2. Use "execute_dql" tool with the following query to get more details about a specific event: "fetch events | filter event.id == \"<event-id>\""`;
+            return resp;
+        }
+        return 'No events found for the specified Kubernetes cluster. Try to leave clusterId and kubernetesEntityId empty to get events from all clusters.';
     });
     tool('get_ownership', 'Get detailed Ownership information for one or multiple entities on Dynatrace', {
         entityIds: zod_1.z.string().optional().describe('Comma separated list of entityIds'),
@@ -774,7 +811,8 @@ You can now execute new Grail queries (DQL, etc.) again. If this happens more of
                 }
                 catch (error) {
                     res.writeHead(400, { 'Content-Type': 'application/json' });
-                    res.end(JSON.stringify({ error: 'Invalid JSON' }));
+                    // Respond with a JSON-RPC Parse error
+                    res.end(JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } }));
                     return;
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynatrace-oss/dynatrace-mcp-server",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "mcpName": "io.github.dynatrace-oss/Dynatrace-mcp",
   "description": "Model Context Protocol (MCP) server for Dynatrace",
   "keywords": [