Add service_name and deployment_environment filters to exceptions tool (#57)

- Add service_name parameter to filter exceptions by service
- Add deployment_environment parameter to filter by resource attributes
- Update tool description and README documentation
- Add godotenv support for local .env file configuration

This enables more precise exception filtering for debugging specific
services and environments.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <[email protected]>

Author: prathamesh-sonpatki

README.md

@@ -73,7 +73,9 @@ Parameters:
   HH:MM:SS). Leave empty to use lookback_minutes.
 - `end_time_iso` (string, optional): End time in ISO format (YYYY-MM-DD
   HH:MM:SS). Leave empty to default to current time.
+- `service_name` (string, optional): Filter exceptions by service name (e.g., api-service).
 - `span_name` (string, optional): Name of the span to filter by.
+- `deployment_environment` (string, optional): Filter exceptions by deployment environment from resource attributes (e.g., production, staging).
 
 ### get_service_summary
 

go.mod

@@ -16,6 +16,7 @@ require (
 	github.com/google/jsonschema-go v0.2.1-0.20250825175020-748c325cec76 // indirect
 	github.com/google/uuid v1.6.0 // indirect
 	github.com/grpc-ecosystem/grpc-gateway/v2 v2.27.2 // indirect
+	github.com/joho/godotenv v1.5.1 // indirect
 	github.com/yosida95/uritemplate/v3 v3.0.2 // indirect
 	go.opentelemetry.io/auto/sdk v1.1.0 // indirect
 	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.63.0 // indirect

go.sum

@@ -19,6 +19,8 @@ github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/grpc-ecosystem/grpc-gateway/v2 v2.27.2 h1:8Tjv8EJ+pM1xP8mK6egEbD1OgnVTyacbefKhmbLhIhU=
 github.com/grpc-ecosystem/grpc-gateway/v2 v2.27.2/go.mod h1:pkJQ2tZHJ0aFOVEEot6oZmaVEZcRme73eIFmhiVuRWs=
+github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
+github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
 github.com/last9/mcp-go-sdk v0.0.0-20251015185513-1886c8f0ff86 h1:NEWU12yyDqF2LMA37y9X4fn3Y3Y5FGS+JeW+Ngir3Yo=
 github.com/last9/mcp-go-sdk v0.0.0-20251015185513-1886c8f0ff86/go.mod h1:GWkOantadjGvDdTpbuLjmJhmD2G0U9AWQgnXZJDaPrE=
 github.com/modelcontextprotocol/go-sdk v0.3.1 h1:0z04yIPlSwTluuelCBaL+wUag4YeflIU2Fr4Icb7M+o=

internal/telemetry/traces/description.go

@@ -1,14 +1,16 @@
 package traces
 
 const GetExceptionsDescription = `
-	Get server side exceptions over the given time range. 
+	Get server side exceptions over the given time range.
     Includes the exception type, message, stack trace, service name, trace ID and span attributes.
-    
+
     limit: (Optional) The maximum number of exceptions to return. Defaults to 20.
     lookback_minutes: (Recommended) Number of minutes to look back from now. Use this for relative time ranges.
     start_time_iso: (Optional) The start time to get the data from. Leave empty to use lookback_minutes instead.
     end_time_iso: (Optional) The end time to get the data from. Leave empty to default to current time.
+    service_name: (Optional) Filter exceptions by service name (e.g. api-service).
     span_name: (Optional) The name of the span to get the data for. This is often the API endpoint name or controller name.
+    deployment_environment: (Optional) Filter exceptions by deployment environment from resource attributes (e.g. production, staging).
 `
 
 const GetServiceGraphDescription = `

internal/telemetry/traces/exception.go

@@ -18,11 +18,13 @@ import (
 
 // GetExceptionsArgs defines the input structure for getting exceptions
 type GetExceptionsArgs struct {
-	Limit           float64 `json:"limit,omitempty" jsonschema:"Maximum number of exceptions to return (default: 20, range: 1-1000)"`
-	LookbackMinutes float64 `json:"lookback_minutes,omitempty" jsonschema:"Number of minutes to look back from current time (default: 60, range: 1-10080)"`
-	StartTimeISO    string  `json:"start_time_iso,omitempty" jsonschema:"Start time in ISO8601 format (e.g. 2024-06-01T12:00:00Z)"`
-	EndTimeISO      string  `json:"end_time_iso,omitempty" jsonschema:"End time in ISO8601 format (e.g. 2024-06-01T13:00:00Z)"`
-	SpanName        string  `json:"span_name,omitempty" jsonschema:"Filter exceptions by span name (e.g. user_service)"`
+	Limit                 float64 `json:"limit,omitempty" jsonschema:"Maximum number of exceptions to return (default: 20, range: 1-1000)"`
+	LookbackMinutes       float64 `json:"lookback_minutes,omitempty" jsonschema:"Number of minutes to look back from current time (default: 60, range: 1-10080)"`
+	StartTimeISO          string  `json:"start_time_iso,omitempty" jsonschema:"Start time in ISO8601 format (e.g. 2024-06-01T12:00:00Z)"`
+	EndTimeISO            string  `json:"end_time_iso,omitempty" jsonschema:"End time in ISO8601 format (e.g. 2024-06-01T13:00:00Z)"`
+	ServiceName           string  `json:"service_name,omitempty" jsonschema:"Filter exceptions by service name (e.g. api-service)"`
+	SpanName              string  `json:"span_name,omitempty" jsonschema:"Filter exceptions by span name (e.g. user_service)"`
+	DeploymentEnvironment string  `json:"deployment_environment,omitempty" jsonschema:"Filter exceptions by deployment environment from resource attributes (e.g. production, staging)"`
 }
 
 // NewGetExceptionsHandler creates a handler for getting exceptions
@@ -64,10 +66,18 @@ func NewGetExceptionsHandler(client *http.Client, cfg models.Config) func(contex
 		q.Set("end", strconv.FormatInt(endTime.Unix(), 10))
 		q.Set("limit", strconv.Itoa(limit))
 
+		if args.ServiceName != "" {
+			q.Set("service_name", args.ServiceName)
+		}
+
 		if args.SpanName != "" {
 			q.Set("span_name", args.SpanName)
 		}
 
+		if args.DeploymentEnvironment != "" {
+			q.Set("deployment_environment", args.DeploymentEnvironment)
+		}
+
 		u.RawQuery = q.Encode()
 
 		// Create request

main.go

@@ -9,13 +9,19 @@ import (
 	"last9-mcp/internal/models"
 	"last9-mcp/internal/utils"
 
+	"github.com/joho/godotenv"
 	last9mcp "github.com/last9/mcp-go-sdk/mcp"
 	"github.com/modelcontextprotocol/go-sdk/mcp"
 )
 
 func main() {
 	log.Printf("Starting Last9 MCP Server v%s", utils.Version)
 
+	// Load .env file if it exists (ignore errors if file doesn't exist)
+	if err := godotenv.Load(); err != nil {
+		log.Printf("No .env file found or error loading it (this is ok): %v", err)
+	}
+
 	cfg, err := utils.SetupConfig(models.Config{})
 	if err != nil {
 		log.Fatalf("config error: %v", err)