docs.aws.amazon.com
Open in
urlscan Pro
108.138.36.55
Public Scan
URL:
https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/deploy-container-insights-ECS-cluster.html
Submission: On May 30 via api from US — Scanned from DE
Submission: On May 30 via api from US — Scanned from DE
Form analysis 0 forms found in the DOM
Text Content
SELECT YOUR COOKIE PREFERENCES
We use essential cookies and similar tools that are necessary to provide our
site and services. We use performance cookies to collect anonymous statistics so
we can understand how customers use our site and make improvements. Essential
cookies cannot be deactivated, but you can click “Customize cookies” to decline
performance cookies.
If you agree, AWS and approved third parties will also use cookies to provide
useful site features, remember your preferences, and display relevant content,
including relevant advertising. To continue without accepting these cookies,
click “Continue without accepting.” To make more detailed choices or learn more,
click “Customize cookies.”
Accept all cookiesContinue without acceptingCustomize cookies
CUSTOMIZE COOKIE PREFERENCES
We use cookies and similar tools (collectively, "cookies") for the following
purposes.
ESSENTIAL
Essential cookies are necessary to provide our site and services and cannot be
deactivated. They are usually set in response to your actions on the site, such
as setting your privacy preferences, signing in, or filling in forms.
PERFORMANCE
Performance cookies provide anonymous statistics about how customers navigate
our site so we can improve site experience and performance. Approved third
parties may perform analytics on our behalf, but they cannot use the data for
their own purposes.
Allow performance category
Allowed
FUNCTIONAL
Functional cookies help us provide useful site features, remember your
preferences, and display relevant content. Approved third parties may set these
cookies to provide certain site features. If you do not allow these cookies,
then some or all of these services may not function properly.
Allow functional category
Allowed
ADVERTISING
Advertising cookies may be set through our site by us or our advertising
partners and help us deliver relevant marketing content. If you do not allow
these cookies, you will experience less relevant advertising.
Allow advertising category
Allowed
Blocking some types of cookies may impact your experience of our sites. You may
review and change your choices at any time by clicking Cookie preferences in the
footer of this site. We and selected third-parties use cookies or similar
technologies as specified in the AWS Cookie Notice.
CancelSave preferences
UNABLE TO SAVE COOKIE PREFERENCES
We will only store essential cookies at this time, because we were unable to
save your cookie preferences.
If you want to change your cookie preferences, try again later using the link in
the AWS console footer, or contact support if the problem persists.
Dismiss
Contact Us
English
Create an AWS Account
1. AWS
2. ...
3. Documentation
4. Amazon CloudWatch
5. User Guide
Feedback
Preferences
AMAZON CLOUDWATCH
USER GUIDE
* What is Amazon CloudWatch?
* How CloudWatch works
* Concepts
* Resources
* Getting set up
* Getting started
* See the pre-built cross-service dashboard
* See a pre-built dashboard for a single AWS service
* See a pre-built dashboard for a resource group
* CloudWatch billing and cost
* Dashboards
* Create a dashboard
* CloudWatch cross-account observability dashboard
* Cross-account cross-Region dashboards
* Create flexible dashboards with dashboard variables
* Tutorial: Create a Lambda dashboard with function name as the variable
* Tutorial: Create a dashboard that uses a regular expression pattern to
switch between Regions
* Copy a variable to another dashboard
* Create and work with widgets on CloudWatch dashboards
* Add or remove a graph
* Graph metrics manually on a CloudWatch dashboard
* Edit a graph
* Edit a graph
* Move or resize a graph
* Rename a graph
* Add an explorer widget to a CloudWatch dashboard
* Add or remove a line widget
* Add or remove a number widget
* Add or remove a gauge widget
* Add a custom widget to a CloudWatch dashboard
* Details about custom widgets
* Security and JavaScript
* Interactivity in the custom widget
* Create a custom widget
* Sample custom widgets
* Add or remove a text widget
* Add or remove an alarm widget
* Add or remove a table widget
* Link and unlink graphs
* Sharing dashboards
* Use live data
* Viewing an animated dashboard
* Add a dashboard to your favorites list
* Change the period override setting or refresh interval
* Change the time range or time zone format
* Metrics
* Basic monitoring and detailed monitoring
* Query your metrics with CloudWatch Metrics Insights
* Build your queries
* Query components and syntax
* Reserved keywords
* Create alarms on Metrics Insights queries
* Create a Metrics Insights alarm
* Partial data cases
* Use Metrics Insights queries with metric math
* Use natural language to generate and update CloudWatch Metrics Insights
queries
* SQL inference
* Sample queries
* Metrics Insights limits
* Metrics Insights glossary
* Troubleshooting Metrics Insights
* Use metrics explorer to monitor resources by their tags and properties
* Use metric streams
* Set up a metric stream
* Custom setup with Firehose
* Use Quick Amazon S3 setup
* Quick partner setup
* Statistics that can be streamed
* Metric stream operation and maintenance
* Monitor your metric streams with CloudWatch metrics
* Trust between CloudWatch and Firehose
* Metric streams output formats
* JSON format
* OpenTelemetry 1.0.0 format
* Translations with OpenTelemetry 1.0.0 format
* How to parse OpenTelemetry 1.0.0 messages
* OpenTelemetry 0.7.0 format
* Translations with OpenTelemetry 0.7.0 format
* How to parse OpenTelemetry 0.7.0 messages
* Troubleshooting
* View available metrics
* Search for available metrics
* Graphing metrics
* Graph a metric
* Merge two graphs into one
* Use dynamic labels
* Modify the time range or time zone format for a graph
* Zooming in on a graph
* Modify the y-axis for a graph
* Create an alarm from a metric on a graph
* Using anomaly detection
* Use metric math
* Use search expressions in graphs
* Search expression syntax
* Search expression examples
* Creating a graph with a search expression
* Get statistics for a metric
* CloudWatch statistics definitions
* Get statistics for a specific resource
* Aggregate statistics across resources
* Aggregate statistics by Auto Scaling group
* Aggregating statistics by AMI
* Publish custom metrics
* Alarms
* Alarm recommendations for AWS services
* Recommended alarms
* Alarming on metrics
* Create an alarm based on a static threshold
* Create an alarm based on a metric math expression
* Create an alarm based on a Metrics Insights query
* Create an alarm based on a connected data source
* Create an alarm based on anomaly detection
* Alarming on logs
* Combining alarms
* Create a composite alarm
* Suppressing composite alarm actions
* Acting on alarm changes
* Notifying users on alarm changes
* Alarm events and EventBridge
* Managing alarms
* Alarm use cases and examples
* Create a billing alarm
* Create a CPU usage alarm
* Create a load balancer latency alarm
* Create a storage throughput alarm
* Create an alarm on Performance Insights counter metrics from an AWS
database
* Create alarms to stop, terminate, reboot, or recover an EC2 instance
* Alarms and tagging
* Application Signals
* Permissions required for Application Signals
* Enable Application Signals
* Application Signals supported systems
* OpenTelemetry compatibility considerations
* Enable Application Signals on Amazon EKS clusters
* Enable Application Signals on an Amazon EKS cluster with your
services
* Enable Application Signals on a new Amazon EKS cluster with a sample
app
* Enable Application Signals on other platforms with a custom setup
* Use a custom setup to enable Application Signals on Amazon ECS
* Use a custom setup to enable Application Signals on Amazon EC2 and
other platforms
* Troubleshooting your Application Signals installation
* Configuring Application Signals
* Service level objectives (SLOs)
* Monitor your application's operational health
* View your services with the Services page
* View detailed service information
* View your application topology with the service map
* Example: Resolve an operational health issue
* Standard application metrics collected
* Use synthetic monitoring
* Required roles and permissions
* Required roles and permissions for users who manage CloudWatch
canaries
* Required roles and permissions for canaries
* Limiting a user to viewing specific canaries
* Creating a canary
* Using canary blueprints
* Using the CloudWatch Synthetics Recorder for Google Chrome
* Synthetics runtime versions
* Runtime versions using Node.js and Puppeteer
* Runtime versions using Python and Selenium Webdriver
* Writing a canary script
* Writing a Node.js canary script
* Writing a Python canary script
* Library functions available for canary scripts
* Library functions available for Node.js canary scripts
* Library functions available for Python canary scripts using
Selenium
* Scheduling canary runs using cron
* Groups
* Test a canary locally
* Troubleshooting a failed canary
* Troubleshooting a canary on a VPC
* Sample code for canary scripts
* Canaries and X-Ray tracing
* Running a canary on a VPC
* Encrypting canary artifacts
* Viewing canary statistics and details
* CloudWatch metrics published by canaries
* Edit or delete a canary
* Start, stop, delete, or update runtime for multiple canaries
* Monitoring canary events with Amazon EventBridge
* Perform launches and A/B experiments with CloudWatch Evidently
* IAM policies to use Evidently
* Create projects, features, launches, and experiments
* Create a new project
* Use client-side evaluation - powered by AWS AppConfig
* Add a feature to a project
* Use segments to focus your audience
* Create a launch
* Create an experiment
* Manage features, launches, and experiments
* See the current evaluation rules and audience traffic for a feature
* Modify launch traffic
* Modify a launch's future steps
* Modify experiment traffic
* Stop a launch
* Stop an experiment
* Adding code to your application
* Project data storage
* How Evidently calculates results
* View launch results in the dashboard
* View experiment results in the dashboard
* How CloudWatch Evidently collects and stores data
* Using service-linked roles
* CloudWatch Evidently quotas
* Tutorial: A/B testing with the Evidently sample application
* Use CloudWatch RUM
* IAM policies to use CloudWatch RUM
* Set up an application to use CloudWatch RUM
* Step 1: Authorize your application to send data to AWS
* Step 2: Create an app monitor
* (Optional) Step 3: Manually modify the code snippet to configure the
CloudWatch RUM web client
* Step 4: Insert the code snippet into your application
* Step 5: Test your app monitor setup by generating user events
* Configuring the CloudWatch RUM web client
* Regionalization
* Use page groups
* Specify custom metadata
* Send custom events
* Viewing the CloudWatch RUM dashboard
* How CloudWatch RUM sets Apdex scores
* CloudWatch metrics that you can collect with CloudWatch RUM
* Custom metrics and extended metrics
* Data protection and data privacy with CloudWatch RUM
* Information collected by the CloudWatch RUM web client
* Route change timing for single-page applications
* Manage your applications that use CloudWatch RUM
* How do I find a code snippet that I've already generated?
* Edit your application
* Stop using CloudWatch RUM or delete an app monitor
* CloudWatch RUM quotas
* Troubleshooting
* Network monitoring
* Using Internet Monitor
* Supported Regions
* Pricing
* Components
* Internet weather map
* How Internet Monitor works
* Use cases
* Internet Monitor cross-account observability
* Getting started
* Creating a monitor
* Adding resources to your monitor
* Setting your application traffic percentage
* Choosing a city-networks maximum limit
* Publishing internet measurements to S3
* Using a monitor
* Editing or deleting a monitor
* Add or create monitor when you create a VPC
* Add or create monitor from the CloudFront console
* Examples with the CLI
* Internet Monitor dashboard
* Tracking real-time performance and availability
* Exploring historical data
* Using insights to improve your network setup
* Explore data using tools
* CloudWatch Logs Insights
* CloudWatch Contributor Insights
* CloudWatch Metrics
* Athena with S3 logs
* Internet Monitor query interface
* Create alarms
* EventBridge integration
* Troubleshoot errors
* Data protection and data privacy
* Identity and Access Management
* How Internet Monitor works with IAM
* AWS managed policies
* IAM permissions
* Service-linked role
* Quotas
* Using Network Monitor
* How Network Monitor works
* Region availability
* Creating a Network Monitor
* Using the console
* Using the command line or API
* Working with monitors and probes
* Edit a monitor
* Delete a monitor
* Activate or deactivate a probe
* Add a probe to a monitor
* Edit a probe
* Delete a probe
* Tag or untag resources using the command line or API
* Network Monitor dashboards
* Monitor dashboard
* Probe dashboard
* Quotas
* Security
* Data protection
* Infrastructure Security
* Identify and Access management
* How Amazon CloudWatch Network Monitor works with IAM
* Identity-based policy examples
* Troubleshooting
* AWS managed policies
* IAM permissions
* Service-linked roles
* Pricing
* Infrastructure monitoring
* Container Insights
* Setting up Container Insights
* Setting up Container Insights on Amazon ECS
* Setting up Container Insights on Amazon ECS for cluster- and
service-level metrics
* Setting up Container Insights on Amazon ECS using AWS Distro for
OpenTelemetry
* Deploying the CloudWatch agent to collect EC2 instance-level
metrics on Amazon ECS
* Deploying the AWS Distro for OpenTelemetry to collect EC2
instance-level metrics on Amazon ECS clusters
* Set up FireLens to send logs to CloudWatch Logs
* Setting up Container Insights on Amazon EKS and Kubernetes
* Verify prerequisites
* Using the CloudWatch agent with Container Insights enhanced
observability enabled
* Install the Amazon CloudWatch Observability EKS add-on
* Quick Start setup for Container Insights on Amazon EKS and
Kubernetes
* Set up the CloudWatch agent to collect cluster metrics
* Using AWS Distro for OpenTelemetry
* Send logs to CloudWatch Logs
* Set up Fluent Bit as a DaemonSet to send logs to CloudWatch
Logs
* (Optional) Set up Fluentd as a DaemonSet to send logs to
CloudWatch Logs
* (Optional) Set up Amazon EKS control plane logging
* (Optional) Enable App Mesh Envoy access logs
* (Optional) Enable the Use_Kubelet feature for large clusters
* Updating or deleting Container Insights on Amazon EKS and
Kubernetes
* Upgrading to Container Insights with enhanced observability
for Amazon EKS
* Updating the CloudWatch agent container image
* Deleting the CloudWatch agent and Fluent Bit for Container
Insights
* Viewing Container Insights metrics
* Metrics collected by Container Insights
* Amazon ECS Container Insights metrics
* Amazon EKS and Kubernetes Container Insights metrics
* Performance log reference
* Performance log events for Amazon ECS
* Performance log events for Amazon EKS and Kubernetes
* Relevant fields in performance log events for Amazon EKS and
Kubernetes
* Container Insights Prometheus metrics monitoring
* Set up and configure on Amazon ECS clusters
* Set up on Amazon ECS clusters
* Scraping additional Prometheus sources and importing those
metrics
* Detailed guide for autodiscovery on Amazon ECS clusters
* (Optional) Set up sample containerized Amazon ECS workloads for
Prometheus metric testing
* Sample App Mesh workload for Amazon ECS clusters
* Sample Java/JMX workload for Amazon ECS clusters
* Sample NGINX workload for Amazon ECS clusters
* Sample NGINX Plus workload for Amazon ECS clusters
* Tutorial for adding a new Prometheus scrape target: Memcached
on Amazon ECS
* Tutorial for scraping Redis Prometheus metrics on Amazon ECS
Fargate
* Set up and configure on Amazon EKS and Kubernetes clusters
* Set up on Amazon EKS and Kubernetes clusters
* Scraping additional Prometheus sources and importing those
metrics
* (Optional) Set up sample containerized Amazon EKS workloads
for Prometheus metric testing
* Set up AWS App Mesh sample workload for Amazon EKS and
Kubernetes
* Set up AWS App Mesh sample workload on an Amazon EKS
cluster with the EC2 launch type or a Kubernetes cluster
* Set up AWS App Mesh sample workload on an Amazon EKS
cluster with the Fargate launch type
* Set up NGINX with sample traffic on Amazon EKS and
Kubernetes
* Set up memcached with a metric exporter on Amazon EKS and
Kubernetes
* Set up Java/JMX sample workload on Amazon EKS and
Kubernetes
* Set up HAProxy with a metric exporter on Amazon EKS and
Kubernetes
* Tutorial for adding a new Prometheus scrape target: Redis
on Amazon EKS and Kubernetes clusters
* Prometheus metric type conversion by the CloudWatch Agent
* Prometheus metrics collected by the CloudWatch agent
* Viewing your Prometheus metrics
* Prometheus metrics troubleshooting
* Prometheus metrics troubleshooting on Amazon ECS
* Prometheus metrics troubleshooting on Amazon EKS and Kubernetes
clusters
* Integration with Application Insights
* See Amazon ECS lifecycle events within Container Insights
* Troubleshooting Container Insights
* Building your own CloudWatch agent Docker image
* Deploying other CloudWatch agent features in your containers
* Lambda Insights
* Getting started with Lambda Insights
* Available versions of the Lambda Insights extension
* x86-64 platforms
* ARM64 platforms
* Using the console to enable Lambda Insights on an existing Lambda
function
* Using the AWS CLI to enable Lambda Insights on an existing Lambda
function
* Using the AWS SAM CLI to enable Lambda Insights on an existing
Lambda function
* Using AWS CloudFormation to enable Lambda Insights on an existing
Lambda function
* Using the AWS CDK to enable Lambda Insights on an existing Lambda
function
* Using Serverless Framework to enable Lambda Insights on an existing
Lambda function
* Enabling Lambda Insights on a Lambda container image deployment
* Viewing your Lambda Insights metrics
* Integration with Application Insights
* Metrics collected by Lambda Insights
* Troubleshooting and known issues
* Example telemetry event
* Use Contributor Insights to analyze high-cardinality data
* Create a Contributor Insights rule
* Contributor Insights rule syntax
* Example rules
* Viewing Contributor Insights reports
* Graphing metrics generated by rules
* Using Contributor Insights built-in rules
* Detect common application problems with CloudWatch Application Insights
* What is Amazon CloudWatch Application Insights?
* How Application Insights works
* Get started
* Access CloudWatch Application Insights
* Prerequisites
* IAM policy
* Permissions for account-based application onboarding
* Set up, configure, and manage your application
* Console steps
* Command line steps
* Events and notifications
* Application Insights cross-account observability
* Work with component configurations
* Template fragment
* Sections
* Example configurations for relevant services
* Amazon DynamoDB table
* Amazon EC2 Auto Scaling (ASG)
* Amazon EKS cluster
* Amazon Elastic Compute Cloud (EC2) instance
* Amazon Elastic Container Service (Amazon ECS)
* Amazon ECS services
* Amazon ECS tasks
* Amazon Elastic File System (Amazon EFS)
* Amazon FSx
* Amazon Relational Database Service (RDS) Aurora MySQL
* Amazon Relational Database Service (RDS) instance
* Amazon Route 53 health check
* Amazon Route 53 hosted zone
* Amazon Route 53 Resolver endpoint
* Amazon Route 53 Resolver query logging configuration
* Amazon S3 bucket
* Amazon Simple Queue Service (SQS)
* Amazon SNS topic
* Amazon Virtual Private Cloud (Amazon VPC)
* Amazon VPC Network Address Translation (NAT) gateways
* API Gateway REST API stages
* Application Elastic Load Balancing
* AWS Lambda Function
* AWS Network Firewall rule group
* AWS Network Firewall rule group association
* AWS Step Functions
* Customer-grouped Amazon EC2 instances
* Elastic Load Balancing
* Java
* Kubernetes on Amazon EC2
* RDS MariaDB and RDS MySQL
* RDS Oracle
* RDS PostgreSQL
* SAP ASE on Amazon EC2
* SAP ASE High Availability on Amazon EC2
* SAP HANA on Amazon EC2
* SAP HANA High Availability on Amazon EC2
* SAP NetWeaver on Amazon EC2
* SAP NetWeaver High Availability on Amazon EC2
* SQL Always On Availability Group
* SQL failover cluster instance
* Use CloudFormation templates
* Tutorial: Set up monitoring for SAP ASE
* Tutorial: Set up monitoring for SAP HANA
* Tutorial: Set up monitoring for SAP NetWeaver
* View and troubleshoot Application Insights
* Supported logs and metrics
* Amazon Elastic Compute Cloud (EC2)
* Elastic Block Store (EBS)
* Amazon Elastic File System (Amazon EFS)
* Elastic Load Balancer (ELB)
* Application ELB
* Amazon EC2 Auto Scaling groups
* Amazon Simple Queue Server (SQS)
* Amazon Relational Database Service (RDS)
* AWS Lambda function
* Amazon DynamoDB table
* Amazon S3 bucket
* AWS Step Functions
* API Gateway REST API stages
* SAP HANA
* SAP ASE
* SAP ASE High Availability on Amazon EC2
* SAP NetWeaver
* HA Cluster
* Java
* Amazon Elastic Container Service (Amazon ECS)
* Kubernetes on AWS
* Amazon FSx
* Amazon VPC
* Amazon VPC NAT gateways
* Amazon Route 53 health check
* Amazon Route 53 hosted zone
* Amazon Route 53 Resolver endpoint
* AWS Network Firewall rule group
* AWS Network Firewall rule group association
* Metrics with data points requirements
* Recommended metrics
* Performance Counter metrics
* Using the resource health view
* CloudWatch cross-account observability
* Link monitoring accounts with source accounts
* Manage monitoring accounts and source accounts
* Query metrics from other data sources
* Managing access to data sources
* Connect to a prebuilt data source with a wizard
* Create a custom connector to a data source
* Use your custom data source
* Delete a connector to a data source
* Collect metrics, logs, and traces with the CloudWatch agent
* Installing the CloudWatch agent
* Installing the CloudWatch agent using the command line
* Download and configure the CloudWatch agent
* Create IAM roles and users for use with CloudWatch agent
* Installing and running the CloudWatch agent on your servers
* Install the CloudWatch agent using Systems Manager
* Create IAM roles and users for use with the CloudWatch agent
* Download and configure the CloudWatch agent
* Installing the CloudWatch agent on EC2 instances
* Installing the CloudWatch agent on on-premises servers
* Installing the CloudWatch agent on new instances using AWS
CloudFormation
* CloudWatch agent credentials preference
* Verifying the signature of the CloudWatch agent package
* Create the CloudWatch agent configuration file
* Create the CloudWatch agent configuration file with the wizard
* Manually create or edit the CloudWatch agent configuration file
* Enable CloudWatch Application Signals
* Collect network performance metrics
* Collect NVIDIA GPU metrics
* Collect process metrics with the procstat plugin
* Retrieve custom metrics with StatsD
* Retrieve custom metrics with collectd
* Set up and configure Prometheus metrics collection on Amazon EC2
instances
* Install the CloudWatch agent by using the Amazon CloudWatch Observability
EKS add-on
* Metrics collected by the CloudWatch agent
* Common scenarios with the CloudWatch agent
* Troubleshooting the CloudWatch agent
* Embedding metrics within logs
* Publishing logs with the embedded metric format
* Using the client libraries
* Specification: Embedded metric format
* Using the PutLogEvents API to send manually-created embedded metric
format logs
* Using the CloudWatch agent to send embedded metric format logs
* Using the embedded metric format with AWS Distro for OpenTelemetry
* Viewing your metrics and logs in the console
* Setting alarms on metrics created with the embedded metric format
* Services that publish CloudWatch metrics
* AWS usage metrics
* Visualizing your service quotas and setting alarms
* AWS API usage metrics
* CloudWatch usage metrics
* CloudWatch tutorials
* Scenario: Monitor estimated charges
* Scenario: Publish metrics
* Working with AWS SDKs
* Code examples
* Actions
* DeleteAlarms
* DeleteAnomalyDetector
* DeleteDashboards
* DescribeAlarmHistory
* DescribeAlarms
* DescribeAlarmsForMetric
* DescribeAnomalyDetectors
* DisableAlarmActions
* EnableAlarmActions
* GetDashboard
* GetMetricData
* GetMetricStatistics
* GetMetricWidgetImage
* ListDashboards
* ListMetrics
* PutAnomalyDetector
* PutDashboard
* PutMetricAlarm
* PutMetricData
* Scenarios
* Get started with alarms
* Get started with metrics, dashboards, and alarms
* Manage metrics and alarms
* Cross-service examples
* Monitor DynamoDB performance
* Security
* Data protection
* Identity and access management
* How Amazon CloudWatch works with IAM
* Identity-based policy examples
* Troubleshooting
* CloudWatch dashboard permissions update
* Using condition keys to limit access to CloudWatch namespaces
* Using condition keys to limit Contributor Insights users' access to log
groups
* Using condition keys to limit alarm actions
* Using service-linked roles
* Using a service-linked role for CloudWatch RUM
* Using service-linked roles for Application Insights
* AWS managed policies for Application Insights
* Amazon CloudWatch permissions reference
* Compliance validation
* Resilience
* Infrastructure security
* AWS Security Hub
* Interface VPC endpoints
* Security considerations for Synthetics canaries
* Logging API calls with AWS CloudTrail
* Tagging your CloudWatch resources
* Grafana integration
* Cross-account cross-Region CloudWatch console
* Service quotas
* Document history
Setting up Container Insights on Amazon ECS for cluster- and service-level
metrics - Amazon CloudWatch
AWSDocumentationAmazon CloudWatchUser Guide
Setting up Container Insights on existing Amazon ECS clustersSetting up
Container Insights on new Amazon ECS clustersDisabling Container Insights on
Amazon ECS clusters
SETTING UP CONTAINER INSIGHTS ON AMAZON ECS FOR CLUSTER- AND SERVICE-LEVEL
METRICS
PDFRSS
You can enable Container Insights on new and existing Amazon ECS clusters.
Container Insights collects metrics at the cluster, task, and service levels.
You can enable Container Insights using either the Amazon ECS console or the AWS
CLI.
If you're using Amazon ECS on an Amazon EC2 instance, and you want to collect
network and storage metrics from Container Insights, launch that instance using
an AMI that includes Amazon ECS agent version 1.29. For information about
updating your agent version, see Updating the Amazon ECS Container Agent
You can use the AWS CLI to set account-level permission to enable Container
Insights for any new Amazon ECS clusters created in your account. To do so,
enter the following command.
aws ecs put-account-setting --name "containerInsights" --value "enabled"
NOTE
If the customer managed AWS KMS key you use for your Amazon ECS Container
Insights metrics is not already configured to work with CloudWatch, you must
update the key policy to allow for encrypted logs in CloudWatch Logs. You must
also associate your own AWS KMS key with the log group under
/aws/ecs/containerinsights/ClusterName/performance. For more information, see
Encrypt log data in CloudWatch Logs using AWS Key Management Service.
SETTING UP CONTAINER INSIGHTS ON EXISTING AMAZON ECS CLUSTERS
To enable Container Insights on an existing Amazon ECS cluster, enter the
following command. You must be running version 1.16.200 or later of the AWS CLI
for the following command to work.
aws ecs update-cluster-settings --cluster myCICluster --settings name=containerInsights,value=enabled
SETTING UP CONTAINER INSIGHTS ON NEW AMAZON ECS CLUSTERS
There are two ways to enable Container Insights on new Amazon ECS clusters. You
can configure Amazon ECS so that all new clusters are enabled for Container
Insights by default. Otherwise, you can enable a new cluster when you create it.
USING THE AWS MANAGEMENT CONSOLE
You can turn on Container Insights on all new clusters by default, or on an
individual cluster as you create it.
TO TURN ON CONTAINER INSIGHTS ON ALL NEW CLUSTERS BY DEFAULT
1. Open the console at https://console.aws.amazon.com/ecs/v2.
2. In the navigation page, choose Account Settings.
3. Choose Update.
4. To use CloudWatch Container Insights by default for clusters, under
CloudWatch Container Insights, select or clear CloudWatch Container
Insights.
5. Choose Save changes.
If you haven't used the preceding procedure to enable Container Insights on all
new clusters by default, use the following steps to create a cluster with
Container Insights enabled.
TO CREATE A CLUSTER WITH CONTAINER INSIGHTS TURNED ON
1. Open the console at https://console.aws.amazon.com/ecs/v2.
2. In the navigation pane, choose Clusters.
3. On the Clusters page, choose Create cluster.
4. Under Cluster configuration, for Cluster name, enter a unique name.
The name can contain up to 255 letters (uppercase and lowercase), numbers,
and hyphens.
5. To turn on Container Insights, expand Monitoring, and then turn on Use
Container Insights.
You can now create task definitions, run tasks, and launch services in the
cluster. For more information, see the following:
* Creating a task definition
* Running tasks
* Creating a service
SETTING UP CONTAINER INSIGHTS ON NEW AMAZON ECS CLUSTERS USING THE AWS CLI
To enable Container Insights on all new clusters by default, enter the following
command.
aws ecs put-account-setting --name "containerInsights" --value "enabled"
If you didn't use the preceding command to enable Container Insights on all new
clusters by default, enter the following command to create a new cluster with
Container Insights enabled. You must be running version 1.16.200 or later of the
AWS CLI for the following command to work.
aws ecs create-cluster --cluster-name myCICluster --settings "name=containerInsights,value=enabled"
DISABLING CONTAINER INSIGHTS ON AMAZON ECS CLUSTERS
To disable Container Insights on an existing Amazon ECS cluster, enter the
following command.
aws ecs update-cluster-settings --cluster myCICluster --settings name=containerInsights,value=disabled
Javascript is disabled or is unavailable in your browser.
To use the Amazon Web Services Documentation, Javascript must be enabled. Please
refer to your browser's Help pages for instructions.
Document Conventions
Setting up Container Insights on Amazon ECS
Setting up Container Insights on Amazon ECS using AWS Distro for OpenTelemetry
Did this page help you? - Yes
Thanks for letting us know we're doing a good job!
If you've got a moment, please tell us what we did right so we can do more of
it.
Did this page help you? - No
Thanks for letting us know this page needs work. We're sorry we let you down.
If you've got a moment, please tell us how we can make the documentation better.
DID THIS PAGE HELP YOU?
Yes
No
Provide feedback
NEXT TOPIC:
Setting up Container Insights on Amazon ECS using AWS Distro for OpenTelemetry
PREVIOUS TOPIC:
Setting up Container Insights on Amazon ECS
NEED HELP?
* Try AWS re:Post
* Connect with an AWS IQ expert
PrivacySite termsCookie preferences
© 2024, Amazon Web Services, Inc. or its affiliates. All rights reserved.
ON THIS PAGE
* Setting up Container Insights on existing Amazon ECS clusters
* Setting up Container Insights on new Amazon ECS clusters
* Disabling Container Insights on Amazon ECS clusters