Update to Go 1.24 and refresh AGENTS.md documentation (#195)

- Move to Go 1.24 and update dependencies
- Update AGENTS.md to reflect AWS SDK v2 migration patterns and implementation details

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

Assisted-by: Claude <[email protected]>

Signed-off-by: Rafa Porres Molina <[email protected]>

Author: rporres

AGENTS.md

@@ -43,9 +43,9 @@ AWS Resource Exporter is a Prometheus exporter for AWS resources, built in Go. I
 - Service-specific configs extend BaseConfig (RDSConfig, VPCConfig, etc.)
 
 **AWS Client Layer (`pkg/awsclient/`)**
-- Centralized AWS SDK session management
-- Service-specific client wrappers
-- Mock interfaces for testing
+- Centralized AWS SDK v2 config-based client management
+- Service-specific client wrappers with paginator patterns
+- Mock interfaces for testing using golang/mock
 
 **Service Collectors (`pkg/`)**
 - Each AWS service has its own collector: `rds.go`, `vpc.go`, `ec2.go`, `route53.go`, `elasticache.go`, `iam.go`, `msk.go`
@@ -66,7 +66,7 @@ AWS Resource Exporter is a Prometheus exporter for AWS resources, built in Go. I
 
 **AWS Credentials**
 - Environment variables: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION`
-- Standard AWS SDK credential chain support
+- Standard AWS SDK v2 credential chain support with aws.Config
 
 **Metrics Collection**
 - Each service runs on configurable intervals
@@ -75,8 +75,9 @@ AWS Resource Exporter is a Prometheus exporter for AWS resources, built in Go. I
 
 **Testing Strategy**
 - Unit tests for each service collector
-- Mock AWS clients using golang/mock
+- Mock AWS clients using golang/mock with AWS SDK v2 interfaces
 - Test files mirror source file structure (`pkg/*_test.go`)
+- Mock generation: `go generate ./pkg/awsclient/`
 
 ## Exported Metrics
 
@@ -133,3 +134,21 @@ AWS Resource Exporter is a Prometheus exporter for AWS resources, built in Go. I
 ### AWS Client Metrics
 - `aws_resources_exporter_awsclient_api_requests_total` - Total AWS API requests made
 - `aws_resources_exporter_awsclient_api_errors_total` - Total AWS API errors encountered
+
+## Key Implementation Notes
+
+### AWS SDK v2 Migration
+- Project migrated from AWS SDK for Go v1 to v2
+- Uses config-based initialization instead of session-based
+- Paginator patterns replace callback-based pagination
+- Error handling uses smithy errors instead of awserr
+- Type system changes: some fields changed from *int64 to *int32
+- Method signatures updated (removed WithContext suffixes)
+- Import paths use aws-sdk-go-v2 namespace
+
+### Important Patterns
+- All AWS API calls use context.Context for cancellation
+- Pagination handled via AWS SDK v2 paginators (NewListRolesPaginator, etc.)
+- Error metrics incremented at usage sites to avoid double counting
+- IAM metrics use GetAccountSummary API for efficiency instead of listing all roles
+- RDS AllocatedStorage metric handles int32 overflow by casting to int64 before multiplication

go.mod

@@ -1,50 +1,48 @@
 module github.com/app-sre/aws-resource-exporter
 
-go 1.22
+go 1.24
 
 require (
 	github.com/alecthomas/kingpin/v2 v2.4.0
-	github.com/aws/aws-sdk-go v1.55.8
-	github.com/aws/aws-sdk-go-v2 v1.30.3
-	github.com/aws/aws-sdk-go-v2/config v1.27.24
-	github.com/aws/aws-sdk-go-v2/service/ec2 v1.173.0
-	github.com/aws/aws-sdk-go-v2/service/elasticache v1.40.0
-	github.com/aws/aws-sdk-go-v2/service/iam v1.34.0
-	github.com/aws/aws-sdk-go-v2/service/kafka v1.35.1
-	github.com/aws/aws-sdk-go-v2/service/rds v1.82.0
-	github.com/aws/aws-sdk-go-v2/service/route53 v1.42.0
-	github.com/aws/aws-sdk-go-v2/service/servicequotas v1.23.0
-	github.com/aws/aws-sdk-go-v2/service/sts v1.30.1
+	github.com/aws/aws-sdk-go-v2 v1.39.1
+	github.com/aws/aws-sdk-go-v2/config v1.31.10
+	github.com/aws/aws-sdk-go-v2/service/ec2 v1.254.0
+	github.com/aws/aws-sdk-go-v2/service/elasticache v1.50.4
+	github.com/aws/aws-sdk-go-v2/service/iam v1.47.6
+	github.com/aws/aws-sdk-go-v2/service/kafka v1.43.5
+	github.com/aws/aws-sdk-go-v2/service/rds v1.107.1
+	github.com/aws/aws-sdk-go-v2/service/route53 v1.58.3
+	github.com/aws/aws-sdk-go-v2/service/servicequotas v1.32.4
+	github.com/aws/aws-sdk-go-v2/service/sts v1.38.5
+	github.com/aws/smithy-go v1.23.0
 	github.com/golang/mock v1.6.0
-	github.com/prometheus/client_golang v1.20.5
-	github.com/prometheus/client_model v0.6.1
-	github.com/prometheus/common v0.60.0
-	github.com/stretchr/testify v1.9.0
+	github.com/prometheus/client_golang v1.23.2
+	github.com/prometheus/client_model v0.6.2
+	github.com/prometheus/common v0.66.1
+	github.com/stretchr/testify v1.11.1
 	gopkg.in/yaml.v3 v3.0.1
 )
 
 require (
 	github.com/alecthomas/units v0.0.0-20240927000941-0f3dac36c52b // indirect
-	github.com/aws/aws-sdk-go-v2/credentials v1.17.24 // indirect
-	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.16.9 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/configsources v1.3.15 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.6.15 // indirect
-	github.com/aws/aws-sdk-go-v2/internal/ini v1.8.0 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.11.3 // indirect
-	github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.11.17 // indirect
-	github.com/aws/aws-sdk-go-v2/service/sso v1.22.1 // indirect
-	github.com/aws/aws-sdk-go-v2/service/ssooidc v1.26.2 // indirect
-	github.com/aws/smithy-go v1.20.3 // indirect
+	github.com/aws/aws-sdk-go-v2/credentials v1.18.14 // indirect
+	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.8 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/configsources v1.4.8 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.8 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/ini v1.8.3 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.1 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.8 // indirect
+	github.com/aws/aws-sdk-go-v2/service/sso v1.29.4 // indirect
+	github.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.0 // indirect
 	github.com/beorn7/perks v1.0.1 // indirect
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
 	github.com/davecgh/go-spew v1.1.1 // indirect
-	github.com/jmespath/go-jmespath v0.4.0 // indirect
-	github.com/klauspost/compress v1.17.11 // indirect
 	github.com/kr/text v0.2.0 // indirect
 	github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
-	github.com/prometheus/procfs v0.15.1 // indirect
+	github.com/prometheus/procfs v0.16.1 // indirect
 	github.com/xhit/go-str2duration/v2 v2.1.0 // indirect
-	golang.org/x/sys v0.26.0 // indirect
-	google.golang.org/protobuf v1.35.1 // indirect
+	go.yaml.in/yaml/v2 v2.4.2 // indirect
+	golang.org/x/sys v0.35.0 // indirect
+	google.golang.org/protobuf v1.36.8 // indirect
 )