mcpField
A
aws-network-monitoring

aws-network-monitoring

github.com/awsCloud & DevOps3.3k5.0k installsUpdated 1d ago
Repository

About aws-network-monitoring

A skill for installing and configuring Amazon CloudWatch Network Flow Monitor agents on EC2 instances, intended for AWS users monitoring network paths. It covers IAM permissions, installation, activation, verification, and troubleshooting.

Key features

  1. 01Install through SSM Distributor or CLI
  2. 02Configure IAM permissions for metric publishing
  3. 03Activate and verify agent status
  4. 04Troubleshoot 403, missing metrics, and connectivity

Use cases

  1. 01Deploy network monitoring agents on EC2
  2. 02Set least-privilege permissions for metric publishing
  3. 03Verify that agents publish metrics
  4. 04Investigate missing network monitoring data

MCP support

With the AWS MCP server, it can run SSM commands, attach IAM policies, and validate agent status; standard AWS CLI access is also supported.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aws/agent-toolkit-for-aws --skill aws-network-monitoring

After installing, type/aws-network-monitoringin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
agent-install-ec2.md
agent-permissions.md
troubleshooting.md

Details

From the project README

AWS Network Monitoring

Overview

Domain expertise for installing and configuring Amazon CloudWatch Network Flow Monitor agents on EC2 instances. Covers IAM permission setup, agent installation via SSM Distributor or command-line install, agent activation, verification, and troubleshooting.

Network Flow Monitor agents are lightweight software that publish performance metrics (latency, packet loss) to the Network Flow Monitor backend, enabling monitoring of network path health between workloads.

Works best with the AWS MCP server — enables running SSM commands, attaching IAM policies, and validating agent status directly. All guidance also works with standard AWS CLI access.

Routing

User needAction
Installing Network Flow Monitor agents on EC2Read agent-install-ec2.md
Configuring IAM for Network Flow Monitor agentsRead agent-permissions.md
Troubleshooting Network Flow Monitor agents (403, no metrics, connectivity)Read troubleshooting.md
Spans multiple areasRead the most specific reference first, then consult others as needed

Files

FileContent
agent-install-ec2.mdEnd-to-end Network Flow Monitor agent installation via SSM Distributor, activation, verification
agent-permissions.mdIAM policy setup for Network Flow Monitor agent metric publishing
troubleshooting.mdError → cause → fix for Network Flow Monitor agent issues (HTTP 403, missing metrics, connectivity)

Supported versions

For supported Linux distributions, kernel versions, and architectures, see the AWS documentation. Windows is not supported.

Security Considerations

  • Least-privilege IAM: Attach only CloudWatchNetworkFlowMonitorAgentPublishPolicy for publishing metrics and AmazonSSMManagedInstanceCore for SSM management. Do not use *FullAccess policies.
  • Private subnets: When the instance is in a private subnet, prefer VPC endpoints for SSM (com.amazonaws.<region>.ssm, .ssmmessages, .ec2messages) over a NAT gateway to keep traffic on the AWS network.
  • Credential storage: Never embed AWS credentials on the instance; the publish policy MUST be attached to the instance role, not configured as static keys.
  • Audit trail: Ensure CloudTrail is enabled in the account so SSM SendCommand invocations and IAM AttachRolePolicy actions performed during agent setup are logged for security investigations.
  • References: CloudWatch Network Flow Monitor security, IAM best practices

Comments

Markdown supported