diff --git a/cid-redirects.json b/cid-redirects.json index e2c7bc62c8..0281d35083 100644 --- a/cid-redirects.json +++ b/cid-redirects.json @@ -3019,6 +3019,7 @@ "/cid/1152": "/docs/send-data/hosted-collectors/cloud-to-cloud-integration-framework/dropbox-source/", "/cid/1155": "/docs/manage/data-masking/", "/cid/1153": "/docs/send-data/opentelemetry-collector/install-collector/docker", + "/cid/1170": "/docs/integrations/amazon-aws/amazon-overview", "/cid/1154": "/docs/send-data/hosted-collectors/krutrim-object-storage", "/cid/1156": "/docs/send-data/opentelemetry-collector/data-source-configurations/windows-active-directory-inventory", "/release-notes-collector/2026/04/11/hosted/": "/release-notes-collector/2026/05/11/hosted/", diff --git a/docs/integrations/amazon-aws/amazon-overview.md b/docs/integrations/amazon-aws/amazon-overview.md new file mode 100644 index 0000000000..f011055d8b --- /dev/null +++ b/docs/integrations/amazon-aws/amazon-overview.md @@ -0,0 +1,80 @@ +--- +id: amazon-overview +title: Amazon Overview +description: The Sumo Logic app for Amazon Overview provides a unified view of your AWS infrastructure with key metrics and logs from multiple AWS services in a single dashboard. +--- + +import useBaseUrl from '@docusaurus/useBaseUrl'; + +Amazon Overview icon + +**Amazon Overview** + +[Amazon Web Services (AWS)](https://aws.amazon.com/) provides secure, scalable cloud computing services and solutions. The Sumo Logic app for Amazon Overview gives you a unified view of your entire AWS infrastructure by aggregating key metrics and logs from multiple AWS services into consolidated dashboards. + +The Sumo Logic Amazon Overview app dashboards provide visibility into your overall AWS environment: +* Monitor activity across all AWS services, including resource activity and geographic distribution of incoming requests. +* Track performance metrics for Application Load Balancer (ALB), Classic Load Balancer (ELB), and Network Load Balancer (NLB), including requests served, errors, healthy/unhealthy hosts, and TLS negotiation errors. +* View EC2 CPU utilization and free memory metrics. +* Monitor RDS CPU utilization and freeable memory. +* Track ElastiCache CPU utilization and freeable memory. +* View Lambda invocations and errors. +* Monitor DynamoDB requests by table and errors. +* Track API Gateway requests by API name and errors. +* Monitor SNS notifications delivered and failed. +* Track SQS messages received and empty receives. +* View ECS average CPU and memory utilization. + +## Installing the Amazon Overview app + +To install the app: + +1. Select **App Catalog**. +1. In the 🔎 **Search Apps** field, run a search for your desired app, then select it. +1. Click **Install App**. + :::note + Sometimes this button says **Add Integration**. + ::: +1. Click **Next**. +1. Look for the dialog confirming that your app was installed successfully.
App success dialog + +**Post-installation** + +Once your app is installed, it will appear in your **Personal** folder or the folder that you specified. From here, you can share it with other users in your organization. Dashboard panels will automatically start to fill with data matching the time range query received since you created the panel. Results won't be available immediately, but within about 20 minutes, you'll see completed graphs and maps. + +## Viewing the Amazon Overview dashboards + +The Sumo Logic app for Amazon Overview provides preconfigured dashboards that give you a unified view of your AWS infrastructure. These dashboards aggregate key metrics and logs from multiple AWS services, helping you monitor performance, track resource utilization, and identify issues across your entire AWS environment. + +### AWS Account Overview + +The **Amazon Overview - AWS Account Overview** dashboard provides a comprehensive view of your AWS account activity and resource performance across all services. + +Use this dashboard to: +* Get a high-level view of your entire AWS infrastructure from a single dashboard. +* Monitor incoming activity locations and AWS resource activity. +* Track load balancer performance, including requests served, errors, and active connections across ALB, ELB, and NLB. +* Monitor compute resource utilization for EC2, ECS, and Lambda. +* View database performance metrics for RDS, DynamoDB, and ElastiCache. +* Track messaging service health for SNS and SQS. +* Monitor API Gateway requests and errors. + +Amazon Overview - AWS Account Overview + +### AWS Region Overview + +The **Amazon Overview - AWS Region Overview** dashboard provides detailed information about your AWS infrastructure filtered by region. + +Use this dashboard to: +* View AWS resource activity and performance metrics for a specific region. +* Compare service performance across different regions. +* Identify region-specific issues with load balancers, compute, databases, or messaging services. +* Monitor regional resource utilization trends. + +Amazon Overview - AWS Region Overview + +## Uninstalling the Amazon Overview app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + diff --git a/docs/integrations/amazon-aws/api-gateway.md b/docs/integrations/amazon-aws/api-gateway.md index 1baf8144c5..44ec92c5fe 100644 --- a/docs/integrations/amazon-aws/api-gateway.md +++ b/docs/integrations/amazon-aws/api-gateway.md @@ -1,6 +1,7 @@ --- id: api-gateway title: AWS API Gateway +sidebar_label: AWS API Gateway description: Amazon API Gateway service allows you to create RESTful APIs, HTTP APIs, and WebSocket APIs for real-time two-way communication applications in containerized and serverless environments, as well as web applications. --- @@ -161,87 +162,6 @@ account=dev region=us-east-1 namespace=aws/apigateway apiname=* apiid stage doma ## Collecting logs and metrics for AWS API Gateway -### Fields in field schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the below fields: - * `apiname` - * `account` - * `namespace` - * `region` - * `accountid` -1. If not present, create it. To learn how to create and manage fields, see [Fields](/docs/manage/fields.md#manage-fields). - -### Field extraction rules - -To learn how to create field extraction rules, [Create a Field Extraction Rules](/docs/manage/field-extractions/create-field-extraction-rule). - -Create a field extraction rule for cloudTrail logs: - -```sumo -Rule Name: AwsObservabilityApiGatewayCloudTrailLogsFER -Applied at: Ingest Time -Scope (Specific Data): -account=* eventname eventsource "apigateway.amazonaws.com" -Parse Expression: -| json "eventSource", "awsRegion", "responseElements", "recipientAccountId" as eventSource, region, responseElements, accountid nodrop -| where eventSource = "apigateway.amazonaws.com" -| "aws/apigateway" as namespace -| json field=responseElements "name" as ApiName nodrop -| tolowercase(ApiName) as apiname -| fields region, namespace, apiname, accountid -``` - -Create a field extraction rule for access logs: - -```sumo -Rule Name: AwsObservabilityApiGatewayAccessLogsFER -Applied at: Ingest Time -Scope (Specific Data): -account=* region=* apiId domainName stage requestId status -Parse Expression: -json "apiId", "domainName", "stage" as apiId, domainName, stage -| "aws/apigateway" as namespace -| apiId as apiName -| fields apiName, namespace, apiId -``` - -Create/Update field extraction rule(s) for cloudwatch logs: - -```sumo -Rule Name: AwsObservabilityGenericCloudWatchLogsFER -Applied at: Ingest Time -Scope (Specific Data): -account=* region=* (_sourceHost=/aws/* or _sourceHost=API*Gateway*Execution*Logs*) -Parse Expression: -if (isEmpty(namespace),"unknown",namespace) as namespace -| if (_sourceHost matches "/aws/lambda/*", "aws/lambda", namespace) as namespace -| if (_sourceHost matches "/aws/rds/*", "aws/rds", namespace) as namespace -| if (_sourceHost matches "/aws/ecs/containerinsights/*", "aws/ecs", namespace) as namespace -| if (_sourceHost matches "/aws/kinesisfirehose/*", "aws/firehose", namespace) as namespace -| if (_sourceHost matches "/aws/apigateway/*", "aws/apigateway", namespace) as namespace -| if (_sourceHost matches "API-Gateway-Execution-Logs*", "aws/apigateway", namespace) as namespace -| parse field=_sourceHost "/aws/lambda/*" as functionname nodrop | tolowercase(functionname) as functionname -| parse field=_sourceHost "/aws/rds/*/*/" as f1, dbidentifier nodrop -| parse field=_sourceHost "/aws/apigateway/*/*" as apiid, stage nodrop -| parse field=_sourceHost "API-Gateway-Execution-Logs_*/*" as apiid, stage nodrop -| apiid as apiName -| tolowercase(dbidentifier) as dbidentifier -| fields namespace, functionname, dbidentifier, apiid, apiName -``` - -### Metrics rules - -Create the following metrics rule for the AWS API Gateway app, if not already created. To learn how to create a metrics rule, see [Metrics Rules Editor](/docs/metrics/metric-rules-editor#create-a-metrics-rule). - -```sql -Rule name: AwsObservabilityApiGatewayApiNameMetricsEntityRule -Metric match expression: Namespace=AWS/ApiGateway apiid=* -Variable name: apiname -Tag sequence: $apiid._1 -Save it -``` - ### Configure Hosted Collector In Sumo Logic, configure a [Hosted Collector](/docs/send-data/hosted-collectors/configure-hosted-collector/). @@ -565,10 +485,31 @@ Enter a parse expression to create an `account` field that maps to the alias you Now that you have set up a collection for the **AWS API gateway**, install the Sumo Logic app to use the pre-configured dashboards that provide visibility into your environment for real-time analysis of overall usage. -import AppInstall from '../../reuse/apps/app-install.md'; +import AppInstall from '../../reuse/apps/app-install-v2.md'; +As part of the app installation process, the following fields will be created by default: + +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for AWS API Gateway Service is AWS/ApiGateway. +- `apiname` API Gateway API name. +- `apiid` API Gateway API id. + +### Field Extraction Rule(s) + +The FER **AwsObservabilityAPIGatewayCloudTrailLogsFER** to extract fields `accountid`, `namespace`, `region`, and `apiname` from CloudTrail logs will be created as a part of app installation. + +The FER **AwsObservabilityAPIGatewayAccessLogsFER** to extract fields `namespace`, `apiid`, and `apiname` from access logs will be created as a part of app installation. + +The FER **AwsObservabilityAPIGatewayCloudWatchLogsFER** to extract fields `namespace`, `apiid`, and `apiname` from CloudWatch logs will be created as a part of app installation. + +### Metric Rule(s) + +The Metric Rule **AwsObservabilityAPIGatewayMetricsRule** for the AWS/ApiGateway namespace will be created as a part of app installation. + ## Viewing AWS API Gateway dashboards import FilterDashboards from '../../reuse/filter-dashboards.md'; @@ -715,3 +656,35 @@ Use these dashboards to: #### AWS API Gateway - Enhanced Monitoring (WebSocket API) Enhanced Monitoring (WebSocket API) + +## Create monitors for AWS API Gateway app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### AWS API Gateway alerts + +| Name | Description | Alert Condition | Recover Condition | +|:-----|:------------|:----------------|:--| +| `AWS API Gateway - High Server-Side Errors` | This alert fires where there are too many API requests (>5%) with server-side errors within 5 minutes. | Count > = 0.05 | Count < 0.05 | +| `AWS API Gateway - High Client-Side Errors` | This alert fires where there are too many API requests (>5%) with client-side errors within 5 minutes. | Count > = 0.05 | Count < 0.05 | +| `AWS API Gateway - High Integration Latency` | This alert fires when we detect the high integration latency for the API requests in a stage within 5 minutes. | Count > = 2000 | Count < 2000 | +| `AWS API Gateway - High Latency` | This alert fires when we detect the high latency in a stage within 5 minutes for REST and HTTP API. | Count > = 2500 | Count < 2500 | +| `AWS API Gateway - Low Traffic API` | This alert fires when there is low message traffic volume for the API within 5 minutes. | Count < = 1 | Count > 1 | +| `AWS API Gateway - High Authorizer Errors` | This alert fires when there are too many API requests (>5%) with authorizer errors within 5 minutes. | Count > 5 | Count < = 5 | +| `AWS API Gateway - High Integration Errors` | This alert fires when there are too many API requests (>5%) with integration errors within 5 minutes. | Count > 5 | Count < = 5 | +| `AWS API Gateway - High WAF Errors` | This alert fires when there are too many API requests (>5%) with WAF errors within 5 minutes. | Count > 5 | Count < = 5 | +| `AWS API Gateway - High WAF Latency` | This alert fires when we detect the high WAF latency for the REST and WebSocket API requests in a stage within 5 minutes. | Count > 1000 | Count < = 1000 | + +## Upgrade/Downgrade the AWS API Gateway app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS API Gateway app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + diff --git a/docs/integrations/amazon-aws/application-load-balancer.md b/docs/integrations/amazon-aws/application-load-balancer.md index 02e999a555..b69b77c74b 100644 --- a/docs/integrations/amazon-aws/application-load-balancer.md +++ b/docs/integrations/amazon-aws/application-load-balancer.md @@ -1,6 +1,7 @@ --- id: application-load-balancer title: AWS Application Load Balancer +sidebar_label: AWS Application Load Balancer description: The Sumo Logic app for AWS Elastic Load Balancing ULM - Application is a unified logs and metrics (ULM) app that gives you visibility into the health of your Application Load Balancer and target groups. --- @@ -109,60 +110,32 @@ Before you begin to use the AWS Elastic Load Balancing (ELB) Application app, co Namespace for AWS Application Load Balancer Service is AWS/ApplicationELB. ::: -## Field in field schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the `loadbalancer` field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields.md#manage-fields). - -## Field Extraction Rule(s) - -Create Field Extraction Rule (FER) for AWS Application Load Balancer access logs and Cloudtrail logs. Learn how to create a Field Extraction Rule [here](/docs/manage/field-extractions/create-field-extraction-rule). - -**AWS Application Load Balancer access logs** - -```sql -Rule Name: AwsObservabilityAlbAccessLogsFER -Applied at: Ingest Time -Scope (Specific Data): account=* region=* (http or https or h2 or grpcs or ws or wss) -``` +## Installing the AWS Application Load Balancer app -```sumo title="Parse Expression" -parse "* * * * * * * * * * * * \"*\" \"*\" * * * \"*\"" as Type, DateTime, loadbalancer, Client, Target, RequestProcessingTime, TargetProcessingTime, ResponseProcessingTime, ElbStatusCode, TargetStatusCode, ReceivedBytes, SentBytes, Request, UserAgent, SslCipher, SslProtocol, TargetGroupArn, TraceId | tolowercase(loadbalancer) as loadbalancer | fields loadbalancer -``` +Now that you have set up collection for AWS Application Load Balancer, install the Sumo Logic App to use the pre-configured searches and dashboards that provide visibility into your environment for real-time analysis of overall usage. -**AWS Application Load Balancer CloudTrail logs** +import AppInstall from '../../reuse/apps/app-install-index-apps-v2.md'; -```sql -Rule Name: AwsObservabilityALBCloudTrailLogsFER -Applied at: Ingest Time -Scope (Specific Data): account=* eventSource eventName "elasticloadbalancing.amazonaws.com" "2015-12-01" -``` + -```sumo title="Parse Expression" -json "eventSource", "awsRegion", "recipientAccountId", "requestParameters.name", "requestParameters.type", "requestParameters.loadBalancerArn", "requestParameters.listenerArn", "apiVersion" as event_source, region, accountid, loadbalancer, loadbalancertype, loadbalancerarn, listenerarn, api_version nodrop -| where event_source = "elasticloadbalancing.amazonaws.com" and api_version matches "2015-12-01" -| "" as namespace -| parse field=loadbalancerarn ":loadbalancer/*/*/*" as balancertype1, loadbalancer1, f1 nodrop -| parse field=listenerarn ":listener/*/*/*/*" as balancertype2, loadbalancer2, f1, f2 nodrop -| if(loadbalancertype matches "network", "aws/networkelb", if(balancertype1 matches "net", "aws/networkelb", if(balancertype2 matches "net", "aws/networkelb", namespace))) as namespace -| if(loadbalancertype matches "application", "aws/applicationelb", if(balancertype1 matches "app", "aws/applicationelb", if(balancertype2 matches "app", "aws/applicationelb", namespace))) as namespace -| where namespace="aws/applicationelb" or isEmpty(namespace) -| if (!isEmpty(loadbalancer), loadbalancer, if (!isEmpty(loadbalancer1), loadbalancer1, loadbalancer2)) as loadbalancer -| toLowerCase(loadbalancer) as loadbalancer -| fields region, namespace, loadbalancer, accountid -``` +As part of the app installation process, the following fields will be created by default: -## Installing the AWS Application Load Balancer app +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for AWS Application Load Balancer Service is AWS/ApplicationELB. +- `loadbalancer` Application Load Balancer name. -Now that you have set up collection for AWS Application Load Balancer, install the Sumo Logic App to use the pre-configured searches and dashboards that provide visibility into your environment for real-time analysis of overall usage. +## Field Extraction Rule(s) -import AppInstallNoDataSourceV2 from '../../reuse/apps/app-install-index-apps-v2.md'; +The FER **AwsObservabilityALBAccessLogsFER** to extract fields `loadbalancer` and `namespace` from access logs will be created as a part of app installation. - +The FER **AwsObservabilityALBCloudTrailLogsFER** to extract fields `accountid`, `namespace`, `region`, and `loadbalancer` from CloudTrail logs will be created as a part of app installation. ## Viewing AWS Application Load Balancer dashboards +We highly recommend you view these dashboards in the [AWS Observability view](/docs/dashboards/explore-view/#aws-observability) of the AWS Observability solution. + ### Overview The **AWS Application Load Balancer - Overview** dashboard provides visibility into the health of your Application Load Balancer and target groups, with at-a-glance views of latency, request and host status, requests from malicious sources, and HTTP backend codes. @@ -173,7 +146,7 @@ Use this dashboard to: * Monitor trends for load balancers errors, 4XX, and 5XX errors, as well as healthy and unhealthy hosts. * Monitor the current state across all load balancers through active connections, new connections, target connection errors, and rejected connections. -AWS Application Load Balancer dashboard +AWS Application Load Balancer - Overview ### Response Analysis @@ -183,7 +156,7 @@ Use this dashboard to: * Monitor incoming client locations for all 5XX, 4XX, and 3XX error responses. * Quickly correlate error responses using load balancer access logs and AWS CloudWatch metrics to determine the possible cause for failures and decide corrective actions. -AWS Application Load Balancer dashboard +AWS Application Load Balancer - Response Analysis ### Target Group Response Analysis @@ -193,7 +166,7 @@ Use this dashboard to: * Monitor trends of all response codes for your target groups by LoadBalancer, Target Group, and availability zones. * Correlate response code trends across load balancer access logs and CloudWatch metrics to determine the root cause for failures. -AWS Application Load Balancer dashboard +AWS Application Load Balancer - Target Group Response Analysis ### Latency Overview @@ -203,7 +176,7 @@ Use this dashboard to: * Monitor response times by load balancer, target group, and availability zone. * Monitor client latency and processing times for target groups. -AWS Application Load Balancer dashboard +AWS Application Load Balancer - Latency Overview ### Latency Details @@ -212,7 +185,7 @@ The **AWS Application Load Balancer - Latency Details** dashboard provides insig Use this dashboard to: * Troubleshoot load balancer performance through detailed views across client, request processing, and response time latencies. -AWS Application Load Balancer dashboard +AWS Application Load Balancer - Latency Details ### Connection and Host Status @@ -222,7 +195,7 @@ Use this dashboard to: * Monitor active connections, new connections, rejected connections, and connection errors for the load balancer. * Monitor healthy and unhealthy host counts by the load balancer, target group, and availability zone across your infrastructure. -AWS Application Load Balancer dashboard +AWS Application Load Balancer - Connections and Host Status ### Requests and Processed Bytes @@ -232,7 +205,7 @@ Use this dashboard to: * Monitor client request load, network traffic, and processed bytes to determine how to best configure load balancers for optimal performance. * Determine how to best allocate backend resources and target groups based on load. -AWS Application Load Balancer dashboard +AWS Application Load Balancer - Requests and Processed Bytes ### Threat Intel @@ -242,7 +215,7 @@ Use this dashboard to: * Identify known malicious IPs that access your load-balancers and use firewall access control lists to prevent them from sending you traffic going forward. * Monitor the malicious confidence level for all incoming malicious IP addresses the threats. -AWS Application Load Balancer dashboard +AWS Application Load Balancer - Threat Intel ### CloudTrail Audit @@ -254,4 +227,34 @@ Use this dashboard to: * Investigate specific error events, including their details, frequency, and associated users, enabling faster troubleshooting and resolution of issues. * Identify the most common error types and the users experiencing the highest failure rates, facilitating targeted improvements and user support. -AWS Application Load Balancer dashboard +AWS Application Load Balancer - CloudTrail Audit + +## Create monitors for AWS Application Load Balancer app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### AWS Application Load Balancer alerts + +| Name | Description | Alert Condition | Recover Condition | +|:----------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------|:------------------|:--| +| `AWS Application Load Balancer - Access from Highly Malicious Sources` | This alert fires when an application load balancer is accessed from highly malicious IP addresses within last 5 minutes. | Count > 0 | Count < = 0 | +| `AWS Application Load Balancer - Deletion Alert` | This alert fires when an application load balancer is deleted within last 5 minutes. | Count > = 2 | Count < 2 | +| `AWS Application Load Balancer - High 4XX Errors` | This alert fires when there are too many HTTP requests (>5%) with a response status of 4xx within an interval of 5 minutes. | Count > = 5 | Count < 5 | +| `AWS Application Load Balancer - High 5XX Errors` | This alert fires when there are too many HTTP requests (>5%) with a response status of 5xx within an interval of 5 minutes. | Count > = 5 | Count < 5 | +| `AWS Application Load Balancer - High Latency` | This alert fires when we detect that the average latency for a given application load balancer within a time interval of 5 minutes is greater than or equal to three seconds. | Count > = 3000 | Count < 3000 | +| `AWS Application Load Balancer - Targets Deregistered` | This alert fires when targets are deregistered from an application load balancer within last 5 minutes. | Count > = 1 | Count < 1 | +| `AWS Application Load Balancer - High Unhealthy Host Count` | This alert fires when we detect that the number of unhealthy hosts for a given Application load balancer within a time interval of 5 minutes is greater than or equal to one. | Count > = 1 | Count < 1 | + +## Upgrade/Downgrade the AWS Application Load Balancer app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS Application Load Balancer app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + diff --git a/docs/integrations/amazon-aws/classic-load-balancer.md b/docs/integrations/amazon-aws/classic-load-balancer.md index 37ec08d87b..5f1d269a9a 100644 --- a/docs/integrations/amazon-aws/classic-load-balancer.md +++ b/docs/integrations/amazon-aws/classic-load-balancer.md @@ -1,6 +1,7 @@ --- id: classic-load-balancer title: AWS Classic Load Balancer +sidebar_label: AWS Classic Load Balancer description: The Sumo Logic app for AWS Elastic Load Balancing Classic is a unified logs and metrics (ULM) app which helps you monitor the classic load balancer. --- @@ -111,55 +112,27 @@ Before you can begin to use the AWS Classic Load Balancing (ELB) App, complete t Namespace for **AWS Classic Load Balancer** Service is **AWS/ELB**. ::: -## Field in field schema +## Installing the AWS Classic Load Balancer app -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the **loadbalancername** field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields#manage-fields). - -## Field Extraction Rule(s) - -Create a Field Extraction Rule for AWS Classic Load Balancer access logs and Cloudtrail logs. Learn how to create Field Extraction Rules [here](/docs/manage/field-extractions/create-field-extraction-rule). - -**AWS Classic Load Balancer access logs** - -```sql -Rule Name: AwsObservabilityElbAccessLogsFER -Applied at: Ingest Time -Scope (Specific Data): account=* region=* _sourceCategory=aws/observability/clb/logs -``` -```sumo title="Parse Expression" -| parse "* * * * * * * * * * * \"*\" \"*\" * *" as datetime, loadbalancername, client, backend, request_processing_time, backend_processing_time, response_processing_time, elb_status_code, backend_status_code, received_bytes, sent_bytes, request, user_agent, ssl_cipher, ssl_protocol -| parse regex field=datetime "(?\d{0,4}-\d{0,2}-\d{0,2}T\d{0,2}:\d{0,2}:\d{0,2}\.\d+Z)" -| where !isBlank(loadbalancername) and !isBlank(datetimevalue) -| "aws/elb" as namespace -| tolowercase(loadbalancername) as loadbalancername -| fields loadbalancername, namespace -``` +Now that you have set up a collection for AWS Classic Load Balancer, install the Sumo Logic app to use the pre-configured searches and dashboards that provide visibility into your environment for real-time analysis of overall usage. -**AWS Classic Load Balancer CloudTrail Logs** +import AppInstall from '../../reuse/apps/app-install-v2.md'; -```sql -Rule Name: AwsObservabilityCLBCloudTrailLogsFER -Applied at: Ingest Time -Scope (Specific Data): account=* eventSource eventName "elasticloadbalancing.amazonaws.com" "2012-06-01" -``` + -```sumo title="Parse Expression" -json "eventSource", "awsRegion", "recipientAccountId", "requestParameters.loadBalancerName" as event_source, region, accountid, loadbalancername nodrop -| where event_source = "elasticloadbalancing.amazonaws.com" -| toLowerCase(loadbalancername) as loadbalancername -| "aws/elb" as namespace -| fields region, namespace, loadbalancername, accountid -``` +As part of the app installation process, the following fields will be created by default: -## Install the AWS Classic Load Balancer app +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for AWS Classic Load Balancer Service is AWS/ELB. +- `loadbalancername` Classic Load Balancer name. -Now that you have set up a collection for AWS Classic Load Balancer, install the Sumo Logic app to use the pre-configured searches and dashboards that provide visibility into your environment for real-time analysis of overall usage. +## Field Extraction Rule(s) -import AppInstall from '../../reuse/apps/app-install.md'; +The FER **AwsObservabilityCLBAccessLogsFER** to extract fields `loadbalancername` and `namespace` from access logs will be created as a part of app installation. - +The FER **AwsObservabilityCLBCloudTrailLogsFER** to extract fields `region`, `namespace`, `loadbalancername`, and `accountid` from CloudTrail logs will be created as a part of app installation. ## Viewing the AWS Classic Load Balancer dashboards @@ -172,7 +145,7 @@ Use this dashboard to: * Monitor trends for load balancers errors, 4xx and 5xx errors, as well as healthy and unhealthy hosts. * Monitor the current state across all load balancers via active connections, new connections, backend connection errors, and rejected connections. -AWS Elastic Load Balancer Classic +AWS Classic Load Balancer - Overview ### Response Analysis @@ -183,7 +156,7 @@ Use this dashboard to: * Monitor incoming client locations for all 5XX, 4XX, and 3XX error responses. * Quickly correlate error responses using load balancer access logs and AWS CloudWatch metrics to determine the possible cause for failures and decide corrective actions. -AWS Elastic Load Balancer Classic +AWS Classic Load Balancer - Response Analysis ### Backend Response Analysis @@ -194,7 +167,7 @@ Use this dashboard to: * Monitor trends of all response codes for your backend servers by LoadBalancer and availability zones. * Correlate response code trends across load balancer access logs and CloudWatch metrics to determine the root cause for failures. -AWS Elastic Load Balancer Classic +AWS Classic Load Balancer - Backend Response Analysis ### Latency Overview @@ -204,7 +177,7 @@ Use this dashboard to: * Monitor response times by load balancer, and availability zone. * Monitor client latency and processing times for backend servers. -AWS Elastic Load Balancer Classic +AWS Classic Load Balancer - Latency Overview ### Latency Details @@ -213,7 +186,7 @@ The **The AWS Classic Load Balancer - Latency Details** dashboard provides insig Use this dashboard to troubleshoot load balancer performance via detailed views across client, request processing, and response time latencies. -AWS Elastic Load Balancer Classic +AWS Classic Load Balancer - Latency Details ### Connection and Host Status @@ -223,7 +196,7 @@ Use this dashboard to: * Monitor active connections, new connections, rejected connections, and connection errors for load balancers. * Monitor healthy and unhealthy host counts by the load balancer and availability zone across your infrastructure. -AWS Elastic Load Balancer Classic +AWS Classic Load Balancer - Connections and Host Status ### Requests and Processed Bytes @@ -233,7 +206,7 @@ Use this dashboard to: * Monitor client request load, network traffic, and processed bytes to determine how to configure load balancers for optimal performance best. * Determine how to allocate best backend resources based on load. -AWS Elastic Load Balancer Classic +AWS Classic Load Balancer - Requests and Processed Bytes ### Threat Intel @@ -243,7 +216,7 @@ Use this dashboard to: * Identify known malicious IPs that are accessing your load-balancers and use firewall access control lists to prevent them from sending you traffic going forward. * Monitor malicious confidence level for all incoming malicious IP addresses posing the threats. -AWS Elastic Load Balancer Classic +AWS Classic Load Balancer - Threat Intel ### CloudTrail Audit @@ -255,4 +228,35 @@ Use this dashboard to: * Investigate specific error events, including their details, frequency, and associated users, enabling faster troubleshooting and resolution of issues. * Identify the most common error types and the users experiencing highest failure rates, facilitating targeted improvements and user support. -AWS Elastic Load Balancer Classic \ No newline at end of file +AWS Classic Load Balancer - CloudTrail Audit + +## Create monitors for AWS Classic Load Balancer app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### AWS Classic Load Balancer alerts + +| Name | Description | Alert Condition | Recover Condition | +|:-----|:------------|:----------------|:--| +| `AWS Classic Load Balancer - Access from Highly Malicious Sources` | This alert fires when the classic load balancer is accessed from highly malicious IP addresses within last 5 minutes. | Count > 0 | Count < = 0 | +| `AWS Classic Load Balancer - Deletion Alert` | This alert fires when we detect greater than or equal to 2 application load balancers are deleted over a 5 minute time-period. | Count > = 2 | Count < 2 | +| `AWS Classic Load Balancer - High 4XX Errors` | This alert fires when there are too many HTTP requests (>5%) with a response status of 4xx within an interval of 5 minutes. | Count > = 5 | Count < 5 | +| `AWS Classic Load Balancer - High 5XX Errors` | This alert fires when there are too many HTTP requests (>5%) with a response status of 5xx within an interval of 5 minutes. | Count > = 5 | Count < 5 | +| `AWS Classic Load Balancer - High Latency` | This alert fires when we detect that the average latency for a given classic load balancer within a time interval of 5 minutes is greater than or equal to three seconds. | Count > = 3000 | Count < 3000 | +| `AWS Classic Load Balancer - Targets Deregistered` | This alert fires when we detect greater than or equal to 1 target is de-registered over a 5 minute time-period. | Count > = 1 | Count < 1 | +| `AWS Classic Load Balancer - Spillover Count` | This alert fires when a Classic load balancer spillover count is greater than 0 within a 5 minute interval, indicating that the surge queue is full and new connections are being rejected. | Count > 0 | Count < = 0 | +| `AWS Classic Load Balancer - High Unhealthy Host Count` | This alert fires when the unhealthy host percentage for a Classic load balancer is greater than or equal to 50% within a 5 minute interval. | Count > = 50 | Count < 50 | + +## Upgrade/Downgrade the AWS Classic Load Balancer app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS Classic Load Balancer app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + \ No newline at end of file diff --git a/docs/integrations/amazon-aws/dynamodb.md b/docs/integrations/amazon-aws/dynamodb.md index 317ff60932..f2df1da192 100644 --- a/docs/integrations/amazon-aws/dynamodb.md +++ b/docs/integrations/amazon-aws/dynamodb.md @@ -1,6 +1,7 @@ --- id: dynamodb title: Amazon DynamoDB +sidebar_label: Amazon DynamoDB description: The Sumo Logic app for DynamoDB provides operational insight into your database environment and Dashboards displaying the events, errors, latency, and capacity of your DynamoDB environment. --- @@ -107,31 +108,6 @@ Namespace for **Amazon DynamoDB** Service is **AWS/DynamoDB**. 2. Click **Save**. -### Field in Field Schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the “**tablename**” field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields.md#manage-fields). - - -### Field Extraction Rule(s) - -Create Field Extraction Rule for CloudTrail Logs. Learn how to create Field Extraction Rule [here](/docs/manage/field-extractions/create-field-extraction-rule). - -```sql -Rule Name: AwsObservabilityDynamoDBCloudTrailLogsFER -Applied at: Ingest Time -Scope (Specific Data): -account=* eventname eventsource "dynamodb.amazonaws.com" -Parse Expression: -| json "eventSource", "awsRegion", "requestParameters.tableName", "recipientAccountId" as eventSource, region, tablename, accountid nodrop -| where eventSource = "dynamodb.amazonaws.com" -| "aws/dynamodb" as namespace -| tolowercase(tablename) as tablename -| fields region, namespace, tablename, accountid -``` - - ### Centralized AWS CloudTrail Log Collection In case you have a centralized collection of CloudTraillogs and are ingesting them from all accounts into a single Sumo Logic CloudTraillog source, create following Field Extraction Rule to map proper AWS account(s) friendly name/alias. Create it if not already present / update it as required. @@ -158,10 +134,21 @@ Enter a parse expression to create an “account” field that maps to the alias Now that you have set up a collection for **Amazon DynamoDB**, install the Sumo Logic app to use the pre-configured [dashboards](#viewing-amazon-dynamodb-dashboards) that provide visibility into your environment for real-time analysis of overall usage. -import AppInstall from '../../reuse/apps/app-install.md'; +import AppInstall from '../../reuse/apps/app-install-v2.md'; +As part of the app installation process, the following fields will be created by default: + +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for Amazon DynamoDB Service is AWS/DynamoDB. +- `tablename` DynamoDB table name. + +### Field Extraction Rule(s) + +The FER **AwsObservabilityDynamoDBCloudTrailLogsFER** to extract fields `region`, `namespace`, `tablename`, and `accountid` will be created as a part of app installation. ## Viewing Amazon DynamoDB dashboards @@ -178,7 +165,7 @@ Use this dashboard to: * Monitor average read and write capacity percentages for DynamoDB instances * Quickly identify system errors, user errors, transaction conflicts, and conditional check fail requests for DynamoDB Monitor overall resource utilization of your DynamoDB instances -Amazon DynamoDB +AWS DynamoDB - Overview ### Capacity Planning @@ -190,7 +177,7 @@ Use this dashboard to: * Monitor AWS account level maximum allocations across reading and writing capacities. * Monitor resource utilization using trend panels for reading and write capacity, throttled read and write requests, as well as read and write throttle events for DynamoDB throughout your infrastructure. -Amazon DynamoDB +AWS DynamoDB - Capacity Planning ### Latency and Errors @@ -201,7 +188,7 @@ Use this dashboard to: * Quickly identify the number of conditional checks that fail, and transaction conflicts for DynamoDB * Monitor resource utilization using trend panels for latencies and errors for DynamoDB -Amazon DynamoDB +AWS DynamoDB - Latency and Errors ### Events @@ -212,7 +199,7 @@ Use this dashboard to: * Monitor DynamoDB activities and ensure they are in line with expectations. * Monitor different types of table events, such as create, update, and describe tables. * Quickly identify the top DynamoDB related errors -Amazon DynamoDB +AWS DynamoDB - Events ### Threat Intel @@ -222,4 +209,36 @@ Use this dashboard to: * Identify malicious IPs performing operations on DynamoDB tables using Sumo Logic Threat Intel. -Amazon DynamoDB \ No newline at end of file +AWS DynamoDB - Threat Intel + +## Create monitors for Amazon DynamoDB app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### Amazon DynamoDB alerts + +| Name | Description | Alert Condition | Recover Condition | +|:-----|:------------|:----------------|:--| +| `AWS DynamoDB - High Account Provisioned Read Capacity` | This alert fires when we detect that the average read capacity provisioned for an account for a time interval of 5 minutes is greater than or equal to 80%. | Count > = 80 | Count < 80 | +| `AWS DynamoDB - High Account Provisioned Write Capacity` | This alert fires when we detect that the average write capacity provisioned for an account for a time interval of 5 minutes is greater than or equal to 80%. | Count > = 80 | Count < 80 | +| `AWS DynamoDB - High Max Provisioned Table Read Capacity` | This alert fires when we detect that the average percentage of read provisioned capacity used by the highest read provisioned table of an account for a time interval of 5 minutes is greater than or equal to 80%. | Count > = 80 | Count < 80 | +| `AWS DynamoDB - High Max Provisioned Table Write Capacity` | This alert fires when we detect that the average percentage of write provisioned capacity used by the highest write provisioned table of an account for a time interval of 5 minutes is greater than or equal to 80%. | Count > = 80 | Count < 80 | +| `AWS DynamoDB - High Read Throttle` | This alert fires when we detect that the total read throttle events for a DynamoDB table is high (>5) for a time interval of 5 minutes. | Count > 5 | Count < = 5 | +| `AWS DynamoDB - High Write Throttle` | This alert fires when we detect that the total write throttle events for a DynamoDB table is high (>5) for a time interval of 5 minutes. | Count > 5 | Count < = 5 | +| `AWS DynamoDB - Multiple Tables deleted` | This alert fires when five or more tables are deleted within 15 minutes. | Count > = 5 | Count < 5 | +| `AWS DynamoDB - System Errors` | This alert fires when we detect system errors for a DynamoDB table is high (>10) for a time interval of 5 minutes. | Count > 10 | Count < = 10 | +| `AWS DynamoDB - High Request Latency` | This alert fires when we detect that the average successful request latency for a DynamoDB table is high (>20ms) for a time interval of 5 minutes. High latency indicates potential issues such as hot partitions, oversized items, or degraded table performance. | Count > 20 | Count < = 20 | + +## Upgrade/Downgrade the Amazon DynamoDB app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the Amazon DynamoDB app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + \ No newline at end of file diff --git a/docs/integrations/amazon-aws/ec2-cloudwatch-metrics.md b/docs/integrations/amazon-aws/ec2-cloudwatch-metrics.md index a25630b8da..194dd5d266 100644 --- a/docs/integrations/amazon-aws/ec2-cloudwatch-metrics.md +++ b/docs/integrations/amazon-aws/ec2-cloudwatch-metrics.md @@ -152,43 +152,6 @@ To configure a CloudTrail Source, perform these steps: 12. **Enable Multiline Processing**. Select the **Detect messages spanning multiple lines** check box, and select **Infer Boundaries**. 13. Click **Save**. -### Field in Field Schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the “**instanceid**” field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields.md#manage-fields). - - -### CloudTrail Field Extraction Rule - -```sql -Rule Name: AwsObservabilityEC2CloudTrailLogsFER -Applied at: Ingest Time -Scope (Specific Data): account=* eventname eventsource "ec2.amazonaws.com" -``` - - -**Parse Expression** - -```sumo -| json "eventSource", "awsRegion", "requestParameters", "responseElements", "recipientAccountId" as eventSource, region, requestParameters, responseElements, accountid nodrop -| where eventSource = "ec2.amazonaws.com" -| "aws/ec2" as namespace -| json field=requestParameters "instanceType", "instancesSet", "instanceId", "DescribeInstanceCreditSpecificationsRequest.InstanceId.content" as req_instancetype, req_instancesSet, req_instanceid_1, req_instanceid_2 nodrop -| json field=req_instancesSet "item", "items" as req_instancesSet_item, req_instancesSet_items nodrop -| parse regex field=req_instancesSet_item "\"instanceId\":\s*\"(?.*?)\"" nodrop -| parse regex field=req_instancesSet_items "\"instanceId\":\s*\"(?.*?)\"" nodrop -| json field=responseElements "instancesSet.items" as res_responseElements_items nodrop -| parse regex field=res_responseElements_items "\"instanceType\":\s*\"(?.*?)\"" nodrop -| parse regex field=res_responseElements_items "\"instanceId\":\s*\"(?.*?)\"" nodrop -| if (!isBlank(req_instanceid_1), req_instanceid_1, if (!isBlank(req_instanceid_2), req_instanceid_2, if (!isBlank(req_instanceid_3), req_instanceid_3, if (!isBlank(req_instanceid_4), req_instanceid_4, "")))) as req_instanceid -| if (!isBlank(req_instanceid), req_instanceid, res_instanceid) as instanceid -| if (!isBlank(req_instancetype), req_instancetype, res_instancetype) as instanceType -| tolowercase(instanceid) as instanceid -| fields region, namespace, accountid, instanceid -``` - - ### Centralized AWS CloudTrail log collection If you have a centralized collection of CloudTrail logs and are ingesting them from all accounts into a single Sumo Logic CloudTrail log source, create following Field Extraction Rule to map proper AWS account(s) friendly name / alias. Create it if not already present / update it as required. @@ -219,10 +182,22 @@ Enter a parse expression to create an “account” field that maps to the alias Now that you have set up collection for AWS EC2 metrics install the Sumo Logic app to use the pre-configured searches and dashboards that provide visibility into your environment for real-time analysis of overall usage. -import AppInstall from '../../reuse/apps/app-install.md'; +import AppInstall from '../../reuse/apps/app-install-v2.md'; +As part of the app installation process, the following fields will be created by default: + +- `account` Name/alias to the AWS account. +- `accountid` AWS account ID. +- `region` The region to which the resource name belongs. +- `namespace` Namespace for EC2 CW Metrics Service. +- `instanceid` EC2 Instance Id. + +### Field Extraction Rule(s) + +The FER **AwsObservabilityEC2CloudTrailLogsFER** to extract fields `region`, `namespace`, `accountid`, and `instanceid` will be created as a part of app installation. + ## Viewing AWS EC2 dashboards ### Overview (CloudWatch Metrics) @@ -237,7 +212,7 @@ Use this dashboard to: * Identify count of Status checks * Observe all relevant metrics for CPU, Internal Disk Store, Network utilization per instance type -AWS EC2 Overview (CloudWatch Metrics) dashboard +AWS EC2 Overview (CloudWatch Metrics) dashboard ### Summary (CloudWatch Metrics) @@ -250,7 +225,7 @@ Use this dashboard to: * Observe Instance Disk Store (Disk Read/Write - Bytes & ops) for EC2 instance. * Monitor Network usage metrics (Network in/out - Byes & packets) for EC2 instance -AWS EC2 Summary (CloudWatch Metrics) dashboard +AWS EC2 Summary (CloudWatch Metrics) dashboard ### Events @@ -263,7 +238,7 @@ Use this dashboard to: * Monitor top IAM Users, Assumed Role Users, and User agents * Monitor distribution of Successful and failed events with the list of latest events. -AWS EC2 - Events (CloudTrail) dashboard +AWS EC2 - Events (CloudTrail) dashboard ### CPU (CloudWatch Metrics) @@ -274,7 +249,7 @@ Use this dashboard to: * Observe CPU Credits metrics (Usage and balance) over time. * Identify CPU Surplus Credits (Charged and Balance) over time. -AWS EC2 CPU (CloudWatch Metrics) dashboard +AWS EC2 CPU (CloudWatch Metrics) dashboard ### EBS (CloudWatch Metrics) @@ -285,7 +260,7 @@ Use this dashboard to: * Monitor EBS read and write ops over time * EBS IO balance and Byte Balance % metric over time for Ec2 instances. -AWS EC2 EBS (CloudWatch Metrics) dashboard +AWS EC2 EBS (CloudWatch Metrics) dashboard ### Disk (CloudWatch Metrics) @@ -296,7 +271,7 @@ Use this dashboard to: * Monitor instance store - Disk metrics like Disk read/write Bytes and Byte rate * Monitor instance store - Disk netrucs like Disk read/write Operations and Operation rate. -AWS EC2 Disk (CloudWatch Metrics) dashboard +AWS EC2 Disk (CloudWatch Metrics) dashboard ### Network (CloudWatch Metrics) @@ -307,7 +282,7 @@ Use this dashboard to: * Monitor imported network metrics like - Byte rate for input and out put and Bytes going in and out of Ec2 instances * Observe network metrics for Ec2 for packet in/out and rate of the packets. -AWS EC2 Network (CloudWatch Metrics) dashboard +AWS EC2 Network (CloudWatch Metrics) dashboard ### Status Check (CloudWatch Metrics) @@ -318,4 +293,35 @@ Use this dashboard to: * Monitor if the instance has passed the status check at last minute * Monitor if an instance has passed the system status check at last minute -AWS EC2 Status Check (CloudWatch Metrics) dashboard +AWS EC2 Status Check (CloudWatch Metrics) dashboard + +## Create monitors for AWS EC2 app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### AWS EC2 alerts + +| Name | Description | Alert Condition | Recover Condition | +|:-----|:------------|:----------------|:--| +| `AWS EC2 CW - High CPU Utilization` | This alert fires when the average CPU utilization based on cloud watch metrics, within a 5 minute interval for an EC2 instance is high (>=85%). | Count > 85 | Count <= 85 | +| `AWS EC2 CW - Status Check Failed` | This alert fires when there is a status check failures within a 5 minute interval for an EC2 instance. | Count > 0 | Count <= 0 | +| `AWS EC2 - High Disk Utilization` | This alert fires when the average disk utilization within a 5 minute time interval for an EC2 instance is high (>=85%). | Count >= 85 | Count < 85 | +| `AWS EC2 - High Memory Utilization` | This alert fires when the average memory utilization within a 5 minute interval for an EC2 instance is high (>=85%). | Count >= 85 | Count < 85 | +| `AWS EC2 - High System CPU Utilization` | This alert fires when the average system CPU utilization within a 5 minute interval for an EC2 instance is high (>=85%). | Count >= 85 | Count < 85 | +| `AWS EC2 - High Total CPU Utilization` | This alert fires when the average total CPU utilization within a 5 minute interval for an EC2 instance is high (>=85%). | Count >= 85 | Count < 85 | +| `AWS EC2 CW - Low EBS IO Credit Balance` | This alert fires when the average EBS IO Balance percentage within a 5 minute interval for an EC2 instance is low (<=10%), indicating the instance is close to being throttled on EBS IOPS. | Count <= 10 | Count > 10 | +| `AWS EC2 CW - Low CPU Credit Balance` | This alert fires when the average CPU Credit Balance within a 30 minute interval for an EC2 instance is low (<=5), indicating a burstable instance is close to losing burst capability and will be limited to baseline performance. | Count <= 5 | Count > 5 | + +## Upgrade/Downgrade the AWS EC2 app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS EC2 app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + diff --git a/docs/integrations/amazon-aws/ec2-host-metrics.md b/docs/integrations/amazon-aws/ec2-host-metrics.md index 1984c4ee9f..9968d97b4d 100644 --- a/docs/integrations/amazon-aws/ec2-host-metrics.md +++ b/docs/integrations/amazon-aws/ec2-host-metrics.md @@ -138,7 +138,7 @@ Use this dashboard to: * Identify trends and deviations in resource usage across instance types, based upon which you can identify which instance types need to be resized. * Monitor average CPU utilization by instance type. -EC2 host metrics dashboard +Host Metrics (EC2) - Overview ### AWS EC2 - Summary (Host OS Metrics) @@ -150,7 +150,7 @@ Use this dashboard to: * Determine if an instance needs to be resized based on utilization. * Identify potential infrastructure issues by identifying deviations in trends and monitoring. -EC2 host metrics dashboard +Host Metrics (EC2) - Summary ### AWS EC2 - CPU @@ -161,7 +161,7 @@ Use this dashboard to: * Quickly identify if high CPU utilization for an EC2 instance is potentially causing a production issue. * Determine how CPU cycles are being spent across CPU user time, system time, and IO wait time. -EC2 host metrics dashboard +Host Metrics (EC2) - CPU ### AWS EC2 - Memory (Host OS Metrics) @@ -172,7 +172,7 @@ Use this dashboard to: * Quickly identify if high memory utilization for an EC2 instance is potentially causing a production issue * Determine how memory is being used across buffers and cache memory. -EC2 host metrics dashboard +Host Metrics (EC2) - Memory ### AWS EC2 - Disk (Host OS Metrics) @@ -184,7 +184,7 @@ Use this dashboard to: * Determine which directories have the most disk usage. * Determine the performance of your storage by monitoring disk read/write rates. -EC2 host metrics dashboard +Host Metrics (EC2) - Disk ### AWS EC2 - Network (Host OS Metrics) @@ -195,7 +195,7 @@ Use this dashboard to: * Quickly identify if traffic sent and received rates for an EC2 instance is potentially causing a production issue. * Determine if any improvements need to be made to your AWS networking infrastructure for optimal performance. -EC2 host metrics dashboard +Host Metrics (EC2) - Network ### AWS EC2 - TCP (Host OS Metrics) @@ -206,4 +206,4 @@ Use this dashboard to: * Quickly identify if TCP traffic for an EC2 instance is potentially causing a production issue. * Identify if any improvements need to be made to optimize TCP traffic by analyzing various TCP connection states. -EC2 host metrics dashboard +Host Metrics (EC2) - TCP diff --git a/docs/integrations/amazon-aws/elastic-container-service-container-insights-cloudwatch.md b/docs/integrations/amazon-aws/elastic-container-service-container-insights-cloudwatch.md index 409a7e0533..51e8a528a5 100644 --- a/docs/integrations/amazon-aws/elastic-container-service-container-insights-cloudwatch.md +++ b/docs/integrations/amazon-aws/elastic-container-service-container-insights-cloudwatch.md @@ -12,10 +12,10 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; Amazon Elastic Container Service (Amazon ECS) is a container management service that allows you to manage Docker containers on a cluster of Amazon EC2 instances. The Sumo Logic app for Amazon ECS provides preconfigured searches and Dashboards that allow you to monitor various metrics (CPU and Memory Utilization, CPU and Memory Reservation) across ECS clusters and services. The app also monitors API calls made by or on behalf of Amazon ECS in your AWS account. We offer two different ECS versions, which have separate data collection steps: -* **[Collect Logs and Metrics for ECS](/docs/integrations/amazon-aws/elastic-container-service)**. This version collects [ECS CloudWatch Metrics](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/available-metrics.html) and [ECS Events using AWS CloudTrail](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/logging-using-cloudtrail.html#service-name-info-in-cloudtrail). For instructions on collecting this data, refer to the [Amazon Elastic Container Service (ECS)](/docs/integrations/amazon-aws/elastic-container-service/). -* **[Collect Logs, Metrics (Container Insights+CloudWatch) and Traces for ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/logging-using-cloudtrail.html#service-name-info-in-cloudtrail)**. This version collects [ECS CloudWatch Metrics](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-metrics.html#available_cloudwatch_metrics), [Container Insights Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-metrics-ECS.html), [ECS Events using AWS CloudTrail](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/logging-using-cloudtrail.html#service-name-info-in-cloudtrail), Application Logs and Traces. Metrics collected by Container Insights are charged as custom metrics. For more information about CloudWatch pricing, see[ Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/). This solution enables you to monitor both ec2 and fargate based ecs deployments. +* **[Collect Logs and Metrics for ECS](/docs/integrations/amazon-aws/elastic-container-service)**. This version collects [ECS CloudWatch Metrics](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/available-metrics.html) and [ECS Events using AWS CloudTrail](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/logging-using-cloudtrail.html#service-name-info-in-cloudtrail). For instructions on collecting this data, refer to the [Amazon Elastic Container Service (ECS)](/docs/integrations/amazon-aws/elastic-container-service/). +* **[Collect Logs, Metrics (Container Insights+CloudWatch) and Traces for ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/logging-using-cloudtrail.html#service-name-info-in-cloudtrail)**. This version collects [ECS CloudWatch Metrics](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-metrics.html#available_cloudwatch_metrics), [Container Insights Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-metrics-ECS.html), [ECS Events using AWS CloudTrail](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/logging-using-cloudtrail.html#service-name-info-in-cloudtrail), and Application Logs and Traces. Metrics collected by Container Insights are charged as custom metrics. For more information about CloudWatch pricing, see [Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/). This solution enables you to monitor both ec2 and fargate based ecs deployments. -This page has instructions for collecting logs and metrics for the Amazon ECS app. It uses the following data: +This page has instructions for collecting logs and metrics for the Amazon ECS app. It uses the following data: * CloudWatch Metrics * Container Insights Metrics * AWS CloudTrail Events @@ -23,11 +23,11 @@ This page has instructions for collecting logs and metrics for the Amazon ECS ap * ECS Application Logs * Traces -## Creating Fields in Field Schema  +## Creating Fields in Field Schema -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. +1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. 1. Search for the following fields: `account`, `namespace`, `region` field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields). +1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields). ## Creating Field Extraction Rule(s) @@ -58,7 +58,7 @@ Parse Expression: | fields region, namespace, accountid ``` -## Collect Metrics for Amazon ECS  +## Collect Metrics for Amazon ECS Sumo Logic supports collecting metrics using two source types: @@ -69,44 +69,44 @@ Sumo Logic supports collecting metrics using two source types: **Metadata**: Add an **account** field to the source and assign it a value which is a friendly name / alias to your AWS account from which you are collecting metrics. Metrics can be queried via the `account field`. -### Collect Container Insights Metrics for Amazon ECS  +### Collect Container Insights Metrics for Amazon ECS -When you enable Container Insights, CloudWatch collects [additional metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-metrics-ECS.html) in the `ECS/ContainerInsights` namespace that describe the status of your ECS tasks, resource usage metrics and the number of running services, containers, and deployments. +When you enable Container Insights, CloudWatch collects [additional metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-metrics-ECS.html) in the `ECS/ContainerInsights` namespace that describe the status of your ECS tasks, resource usage metrics and the number of running services, containers, and deployments. In this step, you'll enable Container Insights and set up a collection to ingest those metrics. -1. Enable Container Insights by referring to the AWS [docs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/deploy-container-insights-ECS-cluster.html) by using cli or AWS console. -2. If Cloudwatch source is selected for collecting metrics, update the source created in "Collect Metrics for Amazon ECS" section to include `ECS/ContainerInsights` in custom namespaces field; or
ECS/ContainerInsights +1. Enable Container Insights by referring to the AWS [docs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/deploy-container-insights-ECS-cluster.html) by using cli or AWS console. +2. If Cloudwatch source is selected for collecting metrics, update the source created in "Collect Metrics for Amazon ECS" section to include `ECS/ContainerInsights` in custom namespaces field.
ECS/ContainerInsights 3. If Kinesis Firehose source is selected for collecting metrics, update the [Metrics Stream](/docs/send-data/hosted-collectors/amazon-aws/aws-kinesis-firehose-metrics-source/#include-metrics-by-namespace) to include `ECS/ContainerInsights` in custom namespaces field. ### Collect ECS events using CloudTrail -To set up an [AWS CloudTrail Source](/docs/send-data/hosted-collectors/amazon-aws/aws-cloudtrail-source) to collect ECS events: +To set up an [AWS CloudTrail Source](/docs/send-data/hosted-collectors/amazon-aws/aws-cloudtrail-source) to collect ECS events: -1. [Configure CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-add-a-trail-using-the-console.html "http://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-add-a-trail-using-the-console.html") in your AWS account. This will create an S3 bucket, if you so choose. +1. [Configure CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-add-a-trail-using-the-console.html) in your AWS account. This will create an S3 bucket, if you so choose. 2. Grant Sumo Logic access to the Amazon S3 bucket. 3. Confirm that logs are being delivered to the Amazon S3 bucket. 4. [**New UI**](/docs/get-started/sumo-logic-ui). In the Sumo Logic main menu select **Data Management**, and then under **Data Collection** select **Collection**. You can also click the **Go To...** menu at the top of the screen and select **Collection**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Collection > Collection**. -5. Navigate to the hosted collector you configured above and select **Add > Add Source**. -6. Select AWS CloudTrail source. -7. **Name.** Enter a name to display the new Source. -8. **Description.** Enter an optional description. -9. **S3 Region.** Select the Amazon Region for your ECS S3 bucket. -10. **Bucket Name.** Enter the exact name of your ECS S3 bucket. -11. **Path Expression.** Enter the string that matches the S3 objects you'd like to collect. You can use a wildcard (`*`) in this string. (DO NOT use a leading forward slash. See [Amazon Path Expressions](/docs/send-data/hosted-collectors/amazon-aws/amazon-path-expressions).)  -12. **Source Category.** Enter `aws/observability/cloudtrail/logs`. -13. **Fields**. Add an **account** field and assign it a value that is a friendly name/alias to your AWS account from which you are collecting logs. Logs can be queried via the "account field". -14. **AWS Access**. There are two options for AWS access:  - - Role-based access. This is the preferred method. You can use this option if you granted access to Amazon ECS as described in [Grant Access to an AWS Product](/docs/send-data/hosted-collectors/amazon-aws/grant-access-aws-product).  For Role-based access enter the Role ARN that was provided by AWS after creating the role. - - For Key access enter the Access Key ID and Secret Access Key. For more information, see [Managing Access Keys for IAM Users](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) in AWS help. -15. **Scan Interval.** Use the default of 5 minutes. Alternately, enter the frequency Sumo Logic will scan your S3 bucket for new data. +5. Navigate to the hosted collector you configured above and select **Add > Add Source**. +6. Select AWS CloudTrail source. +7. **Name.** Enter a name to display the new Source. +8. **Description.** Enter an optional description. +9. **S3 Region.** Select the Amazon Region for your ECS S3 bucket. +10. **Bucket Name.** Enter the exact name of your ECS S3 bucket. +11. **Path Expression.** Enter the string that matches the S3 objects you'd like to collect. You can use a wildcard (`*`) in this string. (DO NOT use a leading forward slash. See [Amazon Path Expressions](/docs/send-data/hosted-collectors/amazon-aws/amazon-path-expressions).) +12. **Source Category.** Enter `aws/observability/cloudtrail/logs`. +13. **Fields**. Add an **account** field and assign it a value that is a friendly name/alias to your AWS account from which you are collecting logs. Logs can be queried via the "account field". +14. **AWS Access**. There are two options for AWS access: + - Role-based access. This is the preferred method. You can use this option if you granted access to Amazon ECS as described in [Grant Access to an AWS Product](/docs/send-data/hosted-collectors/amazon-aws/grant-access-aws-product). For role-based access enter the role ARN that was provided by AWS after creating the role. + - For key access enter the Access Key ID and Secret Access Key. For more information, see [Managing Access Keys for IAM Users](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) in AWS help. +15. **Scan Interval.** Use the default of 5 minutes. Alternately, enter the frequency Sumo Logic will scan your S3 bucket for new data. 16. **Enable Timestamp Parsing**. Select the **Extract timestamp information from log file entries** check box. 17. **Time Zone**. Select **Ignore time zone from the log file and instead use**, and select **UTC** from the dropdown. 18. **Timestamp Format.** Select **Automatically detect the format**. 19. **Enable Multiline Processing**. Select the **Detect messages spanning multiple lines** check box, and select **Infer Boundaries**. -20. Click **Save**. +20. Click **Save**. -## Centralized AWS CloudTrail Log Collection  +## Centralized AWS CloudTrail Log Collection In case you have a centralized collection of CloudTrail logs and are ingesting them from all accounts into a single Sumo Logic CloudTrail log source, create or update the following Field Extraction Rule to map proper AWS account(s) friendly name/alias: @@ -130,40 +130,40 @@ Enter a parse expression to create an `account` field that maps to the alias you | fields account ``` -## Collect Container Insights performance log events for Task and Container  +## Collect Container Insights performance log events for Task and Container -Container Insights collects data as performance log events using [embedded metric format](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format.html). More details [here](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights.html). +Container Insights collects data as performance log events using [embedded metric format](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format.html). More details [here](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContainerInsights.html). In this step, you'll create a source to collect Task and Container level performance events, which are not converted as CloudWatch metrics. -1. Configure an [AWS Kinesis Firehose for Logs Source](/docs/send-data/hosted-collectors/amazon-aws/aws-kinesis-firehose-logs-source). Add the fields account, region and namespace as shown below.
ECS -2. Copy the `KinesisLogsRoleARN` and `KinesisLogsDeliveryStreamARN` values from the outputs tab of Cloudformation.
ECS -3. Go to your CloudWatch > Log Groups and click on your CloudWatch log group `/aws/ecs/containerinsights//performance`.
ECS -4. Click on Create and in opened window fill in the below parameters - 1. Get the delivery stream name from the arn copied in step 2 and fill in the KinesisLogsDeliverStream  field. +1. Configure an [AWS Kinesis Firehose for Logs Source](/docs/send-data/hosted-collectors/amazon-aws/aws-kinesis-firehose-logs-source). Add the fields account, region and namespace as shown below.
ECS +2. Copy the `KinesisLogsRoleARN` and `KinesisLogsDeliveryStreamARN` values from the outputs tab of CloudFormation.
ECS +3. Go to your **CloudWatch > Log Groups** and click on your CloudWatch log group `/aws/ecs/containerinsights//performance`.
ECS +4. Click on Create and in opened window fill in the below parameters: + 1. Get the delivery stream name from the arn copied in step 2 and fill in the **KinesisLogsDeliverStream** field. 2. Get the role name from the arn copied in step 2 and fill in the role. 3. Specify the filter pattern `{ $.Type = "Container" || $.Type = "Task" }`. 4. Specify the filter name. - 5. Test the pattern and click Start streaming.
ECS + 5. Test the pattern and click **Start streaming**.
ECS ## Collect Application Logs for Amazon ECS -Set up the Container logs collection using the steps in following [docs](/docs/send-data/collect-from-other-data-sources/aws-fargate-log-collection). You can use awsfirelens driver and avoid sending logs to CloudWatch log groups.  Put account, region and namespace fields also while configuring the source. +Set up the Container logs collection using the steps in the following [docs](/docs/send-data/collect-from-other-data-sources/aws-fargate-log-collection). You can use AWS FireLens driver and avoid sending logs to CloudWatch log groups. Put account, region, and namespace fields also while configuring the source. If your logs are already going to CloudWatch logs groups then you can create a subscription filter to subscribe the log groups to the delivery stream created in the previous step. :::note -Application logs do not contain regions. You have to configure a new Sumo Logic source for each region if you want to avoid creating multiple sources, then you will have to put the [X-SUMO-Fields](/docs/manage/fields#x-sumo-fields-http-header) header inside logConfiguration by creating a custom fluent bit image and specify a custom fluent bit configuration. +Application logs do not contain regions. You have to configure a new Sumo Logic source for each region if you want to avoid creating multiple sources, then you will have to put the [X-SUMO-Fields](/docs/manage/fields#x-sumo-fields-http-header) header inside logConfiguration by creating a custom fluent bit image and specify a custom fluent bit configuration. -For more information, see, [Create a custom Fluent Bit image](/docs/send-data/collect-from-other-data-sources/aws-fargate-log-collection). +For more information, see [Create a custom Fluent Bit image](/docs/send-data/collect-from-other-data-sources/aws-fargate-log-collection). ::: ## Collect Traces for Amazon ECS -To set up collection for traces: +To set up collection for traces: -1. Create a HTTP Traces source by referring to the [docs](/docs/apm/traces/get-started-transaction-tracing/http-traces-source). -2. Install OpenTelemetry Collector by referring to the [docs](/docs/apm/traces/get-started-transaction-tracing/set-up-traces-collection-aws-environments).  +1. Create a HTTP Traces source by referring to the [docs](/docs/apm/traces/get-started-transaction-tracing/http-traces-source). +2. Install OpenTelemetry Collector by referring to the [docs](/docs/apm/traces/get-started-transaction-tracing/set-up-traces-collection-aws-environments). ### Sample log messages @@ -429,7 +429,7 @@ To set up collection for traces: -### Sample query +### Sample query ```sumo title="Deleted Resources Over Time" _sourceCategory=ecs* (DeleteCluster or DeleteService or DeregisterContainerInstance or DeregisterTaskDefinition or StopTask) and !(InternalFailure) @@ -443,43 +443,43 @@ _sourceCategory=ecs* (DeleteCluster or DeleteService or DeregisterContainerInsta | transpose row _timeslice column resource_type ``` -### Install the Sumo Logic app  +## Installing the Amazon ECS app -Now that you have set up a collection for Amazon ECS with Container Insights and CloudWatch, install the Sumo Logic app for Amazon ECS with Container Insights and CloudWatch to use the pre-configured searches and dashboards that provide visibility into your environment for real-time analysis of overall usage. +Now that you have set up a collection for Amazon ECS with Container Insights and CloudWatch, install the Sumo Logic app for Amazon ECS with Container Insights and CloudWatch to use the pre-configured searches and dashboards that provide visibility into your environment for real-time analysis of overall usage. -import AppInstall from '../../reuse/apps/app-install.md'; +import AppInstall2 from '../../reuse/apps/app-install-v2.md'; - + -## Amazon ECS CloudWatch dashboards  +## Amazon ECS CloudWatch dashboards -### Cluster Overview  +### Cluster Overview -The **Amazon ECS - Cluster Overview** dashboard provides a high-level view of the cluster's health along with details on the utilized resources. +The **Amazon ECS - Cluster Overview** dashboard provides a high-level view of the cluster's health along with details on the utilized resources. Use this dashboard to: -- Monitor the memory and CPU utilization of your cluster. +- Monitor the memory and CPU utilization of your cluster. - View abnormal read-write activity and network incoming-outgoing bytes. -Amazon ECS - Cluster Overview dashboard +Amazon ECS - Cluster Overview dashboard ### Cluster Performance Monitoring -The **Amazon ECS - Cluster Performance Monitoring** dashboard provides detailed information on the performance of your cluster, which you can use to fine-tune your cluster. +The **Amazon ECS - Cluster Performance Monitoring** dashboard provides detailed information on the performance of your cluster, which you can use to fine-tune your cluster. Use this dashboard to: - Identify patterns and outliers over time. -- Monitor the performance of your cluster and use linked dashboards to drill down further into the root cause.  +- Monitor the performance of your cluster and use linked dashboards to drill down further into the root cause. -Amazon ECS - Cluster Performance Monitoring dashboard +Amazon ECS - Cluster Performance Monitoring dashboard ### Cluster Resource Reservation -The **Amazon ECS - Cluster Resource Reservation** dashboard provides information on resource reservations which can be used to set the right resource limits. +The **Amazon ECS - Cluster Resource Reservation** dashboard provides information on resource reservations which can be used to set the right resource limits. -Use this dashboard to:  +Use this dashboard to: - Identify the right limits for CPU and memory reservations. @@ -487,51 +487,51 @@ Use this dashboard to:  ### Container Logs -The **Amazon ECS - Container Logs** dashboard provides detailed information on what is happening (errors or recent events) in a container.  +The **Amazon ECS - Container Logs** dashboard provides detailed information on what is happening (errors or recent events) in a container. Use this dashboard to: - View recent logs of your container. - Identify common errors and abnormal spikes in errors. -Amazon ECS - Container Logs** dashboard +Amazon ECS - Container Logs dashboard ### Container Overview -The **Amazon ECS - Container Overview** dashboard provides a high-level view of the health of the container along with details on the utilized resources. +The **Amazon ECS - Container Overview** dashboard provides a high-level view of the health of the container along with details on the utilized resources. Use this dashboard to: - Track the container status and identify the container details like its task definition, image, account, etc. -- Monitor CPU, memory,  disk, and network activity of your container.  +- Monitor CPU, memory, disk, and network activity of your container. -Amazon ECS - Container Overview dashboard +Amazon ECS - Container Overview dashboard ### EC2 LaunchType -The **Amazon ECS - EC2 LaunchType** dashboard provides a high-level view of the health of the cluster along with details on the utilized resources for EC2 launch types. +The **Amazon ECS - EC2 LaunchType** dashboard provides a high-level view of the health of the cluster along with details on the utilized resources for EC2 launch types. Use this dashboard to: - Monitor CPU and memory utilization of clusters with EC2 launch type. - View the number of clusters and tasks with EC2 launch type. -Amazon ECS - EC2 LaunchType dashboard +Amazon ECS - EC2 LaunchType dashboard ### Service Overview -The **Amazon ECS - Service Overview** dashboard provides a high-level view of the health of the services along with details on the utilized resources. +The **Amazon ECS - Service Overview** dashboard provides a high-level view of the health of the services along with details on the utilized resources. Use this dashboard to: - Monitor the number of running, desired, and pending tasks. - Identify services with abnormal CPU, network, memory, and disk activity. -Amazon ECS - Service Overview dashboard +Amazon ECS - Service Overview dashboard ### Service Performance Monitoring -The **Amazon ECS - Service Performance Monitoring** dashboard provides detailed information on the performance of your services which you can use to fine-tune your cluster. +The **Amazon ECS - Service Performance Monitoring** dashboard provides detailed information on the performance of your services which you can use to fine-tune your cluster. Use this dashboard to: @@ -539,22 +539,22 @@ Use this dashboard to: - Track the running, pending, and desired tasks trend. - Monitor the performance of your services and use linked dashboards to drill down further into the root cause. -Amazon ECS - Service Performance Monitoring dashboard +Amazon ECS - Service Performance Monitoring dashboard ### Tasks Definition Family Overview -The **Amazon ECS - Tasks Definition Family Overview** dashboard provides a high-level view of the health of the tasks belonging to a particular task definition family and details on the utilized resources. +The **Amazon ECS - Tasks Definition Family Overview** dashboard provides a high-level view of the health of the tasks belonging to a particular task definition family and details on the utilized resources. Use this dashboard to: - View the number of tasks running with a single task definition family. - Monitor CPU and memory usage by task definition family. -Amazon ECS - Tasks Definition Family Overview dashboard +Amazon ECS - Tasks Definition Family Overview dashboard ### Tasks Overview -The **Amazon ECS - Tasks Overview** dashboard provides a high-level view of the health of the task along with details on the utilized resources and where they are running. +The **Amazon ECS - Tasks Overview** dashboard provides a high-level view of the health of the task along with details on the utilized resources and where they are running. Use this dashboard to: @@ -562,48 +562,73 @@ Use this dashboard to: - Track Network Errors and Dropped Packets - Monitor CPU, memory, disk, and network performance by task instances. -Amazon ECS - Tasks Overview dashboard +Amazon ECS - Tasks Overview dashboard ### Tasks Definition Family Performance Monitoring -The **Amazon ECS - Tasks Definition Family Performance Monitoring** dashboard provides detailed information on the performance of your tasks which you can use to fine-tune your cluster. +The **Amazon ECS - Tasks Definition Family Performance Monitoring** dashboard provides detailed information on the performance of your tasks which you can use to fine-tune your cluster. Use this dashboard to: -- Identify patterns and outliers over time for each of the resource metrics like CPU, memory, network, and disk. -- Monitor the performance of your tasks and use linked dashboards to drill down further into the root cause. +- Identify patterns and outliers over time for each of the resource metrics like CPU, memory, network, and disk. +- Monitor the performance of your tasks and use linked dashboards to drill down further into the root cause. -Amazon ECS - Tasks Definition Family Performance Monitoring dashboard +Amazon ECS - Tasks Definition Family Performance Monitoring dashboard ### Task Definition Family Resource Reservation -The **Amazon ECS - Task Definition Family Resource Reservation** dashboard provides information on resource reservation which can be used to set the right resource limits at the task definition level. +The **Amazon ECS - Task Definition Family Resource Reservation** dashboard provides information on resource reservation which can be used to set the right resource limits at the task definition level. -Use this dashboard to:  +Use this dashboard to: - Identify the right limits for CPU and memory reservations. -Amazon ECS - Task Definition Family Resource Reservation dashboard +Amazon ECS - Task Definition Family Resource Reservation dashboard ### Fargate LaunchType -The **Amazon ECS - Fargate LaunchType** dashboard provides a high-level view of the cluster's health along with details on the utilized resources for Fargate launch types. +The **Amazon ECS - Fargate LaunchType** dashboard provides a high-level view of the cluster's health along with details on the utilized resources for Fargate launch types. Use this dashboard to: - Monitor network activity of your clusters with Fargate launch type. - View the number of clusters and tasks with Fargate launch type. -Amazon ECS - Fargate LaunchType dashboard +Amazon ECS - Fargate LaunchType dashboard -### Audit Events  +### Audit Events -The **Amazon ECS - Audit Events** dashboard gives information on the type of request made to ECS, the IP making the request, who made it and when, and more. +The **Amazon ECS - Audit Events** dashboard gives information on the type of request made to ECS, the IP making the request, who made it and when, and more. Use this dashboard to: - View audit trail of actions taken by a user, role, or AWS service in Amazon ECS. -- Monitor container registration/deregistration events. +- Monitor container registration/deregistration events. - Identify location, IP address from where the request was made, and resource crud events over time. -Amazon ECS - Audit Events dashboard +Amazon ECS - Audit Events dashboard + +## Create monitors for Amazon ECS app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### Amazon ECS alerts + +| Name | Description | Alert Condition | Recover Condition | +|:-----|:------------|:----------------|:--| +| `Amazon ECS - High CPU Utilization` | This alert fires when the average CPU utilization within a 5 minute interval for a service within a cluster is high (>=85%). | Count > = 85 | Count < 85 | +| `Amazon ECS - High Memory Utilization` | This alert fires when the average memory utilization within a 5 minute interval for a service within a cluster is high (>=85%). | Count > = 85 | Count < 85 | + +## Upgrade/Downgrade the Amazon ECS app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the Amazon ECS app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + diff --git a/docs/integrations/amazon-aws/elastic-container-service.md b/docs/integrations/amazon-aws/elastic-container-service.md index 47adbba6f5..1392592221 100644 --- a/docs/integrations/amazon-aws/elastic-container-service.md +++ b/docs/integrations/amazon-aws/elastic-container-service.md @@ -288,26 +288,6 @@ _sourceCategory=ecs* (DeleteCluster or DeleteService or DeregisterContainerInsta | count by resource_type, _timeslice | transpose row _timeslice column resource_type ``` -## Creating Fields in Field Schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the following fields: `account`, `namespace`, `region` field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields). - -## Creating Field Extraction Rule(s) - -Create a Field Extraction Rule for CloudTrail Logs ([learn more](/docs/manage/field-extractions/create-field-extraction-rule)). -```sql -Rule Name: AwsObservabilityECSCloudTrailLogsFER -Applied at: Ingest Time -Scope (Specific Data): -account=* eventname eventsource "ecs.amazonaws.com" -Parse Expression: -| json "eventSource", "awsRegion", "requestParameters.tableName", "recipientAccountId" as eventSource, region, tablename, accountid nodrop -| where eventSource = "ecs.amazonaws.com" -| "aws/ecs" as namespace -| fields region, namespace, accountid -``` ## Collect Logs and Metrics for Amazon ECS This section has instructions for collecting logs and metrics for the Amazon ECS app. @@ -341,10 +321,24 @@ This section has instructions for collecting logs and metrics for the Amazon ECS Now that you have set up collection for Amazon ECS, install the Sumo Logic app for Amazon ECS to use the pre-configured searches and dashboards that provide visibility into your environment for real-time analysis of overall usage. -import AppInstall from '../../reuse/apps/app-install.md'; +import AppInstall from '../../reuse/apps/app-install-v2.md'; +As part of the app installation process, the following fields will be created by default: + +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for Amazon ECS Service is AWS/ECS. +- `clustername` The name of the ECS cluster. + +## Field Extraction Rule(s) + +The FER **AwsObservabilityECSCloudTrailLogsFER** to extract fields `region`, `namespace`, `clustername`, and `accountid` will be created as a part of app installation. + +The FER **AwsObservabilityECSCloudWatchLogsFER** to extract the `namespace` field will be created as a part of app installation. + ## Viewing the Amazon ECS app dashboards import ViewDashboards from '../../reuse/apps/view-dashboards.md'; @@ -362,7 +356,7 @@ Use this dashboard to: * Identify clusters or services with unusually high or low resource usage or reservation percentages. * View details of individual clusters and services, including their regions and associated accounts. -Amazon ECS - Overview +Amazon ECS - Overview ### Audit Events @@ -375,7 +369,7 @@ Use this dashboard to: * Examine details and trends for created, updated and deleted ECS resources. * Investigate specific container registration and deregistration events in different regions and clusters. -Amazon ECS - Audit Events +Amazon ECS - Audit Events ### Resource Utilization @@ -390,7 +384,7 @@ Use this dashboard to: * Identify performance bottlenecks or underutilized resources in your ECS environment. * Compare utilization patterns between clusters and individual services to optimize resource allocation. -Amazon ECS - Resource Utilization +Amazon ECS - Resource Utilization ### Resource Reservation @@ -406,4 +400,29 @@ Use this dashboard to: * Compare reservation patterns between different types of resources (CPU, memory, GPU) over time. -Amazon ECS - Resource Reservation +Amazon ECS - Resource Reservation + +## Create monitors for Amazon ECS app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### Amazon ECS alerts + +| Name | Description | Alert Condition | Recover Condition | +|:-----|:------------|:----------------|:--| +| `Amazon ECS - High CPU Utilization` | This alert fires when the average CPU utilization within a 5 minute interval for a service within a cluster is high (>=85%). | Count > = 85 | Count < 85 | +| `Amazon ECS - High Memory Utilization` | This alert fires when the average memory utilization within a 5 minute interval for a service within a cluster is high (>=85%). | Count > = 85 | Count < 85 | + +## Upgrade/Downgrade the AWS EC2 app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS EC2 app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + \ No newline at end of file diff --git a/docs/integrations/amazon-aws/elasticache.md b/docs/integrations/amazon-aws/elasticache.md index 85b7315187..71ae26a597 100644 --- a/docs/integrations/amazon-aws/elasticache.md +++ b/docs/integrations/amazon-aws/elasticache.md @@ -133,34 +133,6 @@ account={{account}} region={{region}} namespace={{namespace}} "\"eventSource\":\ 2. Click **Save**. -### Field in Field Schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the “**cacheclusterid**” field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields.md#manage-fields). - - -### Field Extraction Rule(s) - -Create a Field Extraction Rule for CloudTrail Logs. Learn how to create a Field Extraction Rule [here](/docs/manage/field-extractions/create-field-extraction-rule). - -```sql -Rule Name: AwsObservabilityElastiCacheCloudTrailLogsFER -Applied at: Ingest Time -Scope (Specific Data): account=* eventname eventsource "elasticache.amazonaws.com" -``` - -**Parse Expression** - -```sumo -| json "eventSource", "awsRegion", "requestParameters.cacheClusterId", "responseElements.cacheClusterId", "recipientAccountId" as eventSource, region, req_cacheClusterId, res_cacheClusterId, accountid nodrop -| where eventSource = "elasticache.amazonaws.com" -| if (!isEmpty(req_cacheClusterId), req_cacheClusterId, res_cacheClusterId) as cacheclusterid -| "aws/elasticache" as namespace -| tolowercase(cacheclusterid) as cacheclusterid -| fields region, namespace, cacheclusterid, accountid -``` - ### Centralized AWS CloudTrail Log Collection In case you have a centralized collection of CloudTrail logs and are ingesting them from all accounts into a single Sumo Logic CloudTrail log source, create the following Field Extraction Rule to map a proper AWS account(s) friendly name / alias. Create it if not already present / update it as required. @@ -190,10 +162,22 @@ This section has instructions for installing the Sumo Logic app for **Amazon Ela Now that you have set up a collection for **Amazon ElastiCache**, install the Sumo Logic app to use the pre-configured dashboards that provide visibility into your environment for real-time analysis of overall usage. -import AppInstall from '../../reuse/apps/app-install.md'; +import AppInstall from '../../reuse/apps/app-install-v2.md'; +As part of the app installation process, the following fields will be created by default: + +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for Amazon ElastiCache service is AWS/ElastiCache. +- `cacheclusterid` A cache cluster ID is a user-supplied, unique name used to identify and manage an Amazon ElastiCache cluster. + +### Field Extraction Rule(s) + +The FER **AwsObservabilityElastiCacheCloudTrailLogsFER** to extract fields `accountid`, `namespace`, `region`, and `cacheclusterid` will be created as a part of app installation. + ## Viewing Amazon ElastiCache dashboards @@ -206,7 +190,7 @@ Use this dashboard to: * CPU, memory or swap space on host and swap usage. * Monitor network traffic utilization and compare today’s trends of incoming and outgoing bytes and packets vs. yesterday -Amazon ElastiCache +Amazon ElastiCache - Host Performance Overview ### Audit Event Overview @@ -218,7 +202,7 @@ Use this dashboard to: * Quickly identify top error codes to diagnose any outages * Monitor trends around failed events to identify potential service disruptions that could warrant deeper investigation -Amazon ElastiCache +Amazon ElastiCache - Audit Event Overview ### Redis Performance Overview @@ -227,7 +211,7 @@ Use this dashboard to: Use this dashboard to: * Quickly determine if your Redis database is performing as expected -Amazon ElastiCache +Amazon ElastiCache - Redis Performance Overview ### Audit Event Details @@ -237,7 +221,7 @@ Use this dashboard to: * Quickly determine changes made to your ElastiCache clusters while troubleshooting production outages * Determine if any nodes hosting your ElastiCache clusters were rebooted -Amazon ElastiCache +Amazon ElastiCache - Audit Event Details ### Host Performance Details @@ -247,7 +231,7 @@ Use this dashboard to: * Get an at-a-glance view of the performance of all nodes within a given ElastiCache cluster * Determine if CPU, memory, swap memory or network resources need to be scaled up or down for a given cluster or service based on utilization trends -Amazon ElastiCache +Amazon ElastiCache - Host Performance Details ### Redis Performance Details @@ -258,7 +242,7 @@ Use this dashboard to: * Review trends around defragmentation, replication lag and bytes replicated to determine optimizations * Quickly determine any authentication and authorization failures and grant or revoke privileges accordingly -Amazon ElastiCache +Amazon ElastiCache - Redis Performance Details ### Redis Command Latency @@ -267,7 +251,7 @@ The **Amazon ElastiCache - Redis Command Latency** dashboard provides detailed i Use this dashboard to: * To optimize performance of your Redis clusters by monitoring latency observed across get/set operations. Latency can be high due to high CPU usage, swapping or removing cached items. Performance optimizations can therefore be made either via resource allocation or by optimizing on caching. -Amazon ElastiCache +Amazon ElastiCache - Redis Command Latency ### Redis Command Stats @@ -279,4 +263,33 @@ Use this dashboard to: If high latency commands are not being processed frequently, you will want to look into monitoring and potentially allocating more CPU resources. -Amazon ElastiCache +Amazon ElastiCache - Redis Command Stats + +## Create monitors for Amazon ElastiCache app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### Amazon ElastiCache alerts + +| Alert Name | Alert Description and Conditions | Alert Condition | Recover Condition | +|:--|:--|:--|:--| +| `Amazon Elasticache - High CPU Utilization` | This alert fires when the average CPU utilization within a 5 minute interval for a host is high (>=90%). The CPUUtilization metric includes total CPU utilization across application, operating system and management processes. We highly recommend monitoring CPU utilization for hosts with two vCPUs or less. | Count >= 90 | Count < 90 | +| `Amazon Elasticache - High Engine CPU Utilization` | This alert fires when the average CPU utilization for the Redis engine process within a 5 minute interval is high (>=90%). For larger node types with four vCPUs or more, use the EngineCPUUtilization metric to monitor and set thresholds for scaling. | Count >= 90 | Count < 90 | +| `Amazon Elasticache - High Redis Database Memory Usage` | This alert fires when the average database memory usage within a 5 minute interval for the Redis engine is high (>=95%). When the value reaches 100%, eviction may happen or write operations may fail based on ElastiCache policies thereby impacting application performance. | Count >= 95 | Count < 95 | +| `Amazon Elasticache - High Redis Memory Fragmentation Ratio` | This alert fires when the average Redis memory fragmentation ratio within a 5 minute interval is high (>=1.5). Value equal to or greater than 1.5 indicates significant memory fragmentation. | Count >= 1.5 | Count < 1.5 | +| `Amazon Elasticache - Low Redis Cache Hit Rate` | This alert fires when the average cache hit rate for Redis within a 5 minute interval is low (<=80%). This indicates low efficiency of the Redis instance. If cache ratio is lower than 80%, that indicates a significant amount of keys are either evicted, expired, or don't exist. | Count <= 80 | Count > 80 | +| `Amazon Elasticache - Multiple Failed Operations` | This alert fires when we detect multiple failed operations within a 15 minute interval for an ElastiCache service. | Count >= 10 | Count < 10 | + +## Upgrade/Downgrade the AWS API Gateway app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS API Gateway app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + \ No newline at end of file diff --git a/docs/integrations/amazon-aws/lambda.md b/docs/integrations/amazon-aws/lambda.md index b25ae89dc0..578bf07390 100644 --- a/docs/integrations/amazon-aws/lambda.md +++ b/docs/integrations/amazon-aws/lambda.md @@ -211,38 +211,6 @@ These metrics can then be queried using Sumo Logic [Metrics queries](/docs/metri Search Provisioned Concurrency Metrics -### Field in Field Schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the “**functionname**” field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields.md#manage-fields). - - -### Field Extraction Rule(s) - -Create a Field Extraction Rule for AWS Lambda. Learn how to create a Field Extraction Rule [here](/docs/manage/field-extractions/create-field-extraction-rule). - - -### Cloud Trail FER - -```sql -Rule Name: AwsObservabilityFieldExtractionRule -Applied at: Ingest Time -Scope (Specific Data): account=* eventname eventsource "lambda.amazonaws.com" -``` - -```sumo title="Parse Expression" -| json "eventSource", "awsRegion", "requestParameters", "recipientAccountId" as eventSource, region, requestParameters, accountid nodrop -| where eventSource = "lambda.amazonaws.com" -| json field=requestParameters "functionName", "resource" as functionname, resource nodrop -| parse regex field=functionname "\w+:\w+:\S+:[\w-]+:\S+:\S+:(?[\S]+)$" nodrop -| parse field=resource "arn:aws:lambda:*:function:*" as f1, functionname2 nodrop -| if (isEmpty(functionname), functionname2, functionname) as functionname -| "aws/lambda" as namespace -| tolowercase(functionname) as functionname -| fields region, namespace, functionname, accountid -``` - ### Centralized AWS CloudTrail Log Collection In case you have a centralized collection of CloudTrail logs and are ingesting them from all accounts into a single Sumo Logic CloudTrail log source, create the following Field Extraction Rule to map the proper AWS account(s) friendly name/alias. Create it if not already present / update it as required. @@ -266,27 +234,28 @@ Enter a parse expression to create an “account” field that maps to the alias | fields account ``` -### Cloud Watch FER - -```yml -Rule Name: AwsObservabilityLambdaCloudWatchLogsFER -Applied at: Ingest Time -Scope (Specific Data): account=* region* _sourceHost=/aws/lambda/* -Parse Expression: -| parse field=_sourceHost "/aws/lambda/*" as functionname -| tolowercase(functionname) as functionname -| "aws/lambda" as namespace -| fields functionname, namespace -``` - ## Installing the AWS Lambda App Now that you have set up collection for AWS Lambda, install the Sumo Logic App to use the pre-configured searches and dashboards that provide visibility into your environment for real-time analysis of overall usage. -import AppInstall from '../../reuse/apps/app-install.md'; +import AppInstall from '../../reuse/apps/app-install-v2.md'; +As part of the app installation process, the following fields will be created by default: + +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for Amazon Lambda Service is AWS/Lambda. +- `functionname` Lambda resource function name. + +### Field Extraction Rule(s) + +The FER **AwsObservabilityLambdaCloudTrailLogsFER** to extract fields `region`, `namespace`, `accountid`, and `functionname` will be created as a part of app installation. + +The FER **AwsObservabilityLambdaCloudWatchLogsFER** to extract fields `functionname` and `namespace` will be created as a part of app installation. + ## Viewing AWS Lambda dashboards The following measurements and calculations drive the information shown in the dashboard panels: @@ -312,12 +281,12 @@ Use this dashboard to: * Identify and validate the top IAM Users and AWS services that invoke AWS Lambda functions. * Monitor cold start duration for Lambda functions. -AWS Lambda +AWS Lambda - Overview ### Request Analysis -**The AWS Lambda - Request Analysis** dashboard provides deeper insights into the invocations, operations, and performance of your AWS Lambda functions. +The **AWS Lambda - Request Analysis** dashboard provides deeper insights into the invocations, operations, and performance of your AWS Lambda functions. Use this dashboard to: * Monitor the invocation of an AWS Lambda function against all other functions. @@ -326,12 +295,12 @@ Use this dashboard to: * Troubleshoot and investigate individual function requests. * Monitor cold start duration and key operations for Lambda functions. -AWS Lambda +AWS Lambda - Request Analysis ### Usage Analysis -**AWS Lambda - Usage Analysis** dashboard offers insights into function usage, including invocations, calling AWS services, user agents, IAM users, and detailed information about function callers. +The **AWS Lambda - Usage Analysis** dashboard offers insights into function usage, including invocations, calling AWS services, user agents, IAM users, and detailed information about function callers. :::note This dashboard provides analysis of AWS CloudTrail Data Events. By default, AWS CloudTrail does not log data events. To enable AWS CloudTrail data events, refer to [AWS Lambda Data Event](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console) @@ -345,7 +314,7 @@ Use this dashboard to: * Identify top callers, top caller types. * Monitor the invocation of an AWS Lambda function. -AWS Lambda +AWS Lambda - Usage Analysis ### Error Analysis @@ -362,12 +331,12 @@ Use this dashboard to: * Monitor the trend for recursive invocation drops. This measures the number of recursive invocation attempts that were dropped to prevent potential infinite loops and unbounded recursion within Lambda functions. * Monitor the trend for destination delivery failures. This tracks the number of times Lambda failed to deliver an asynchronous invocation result to a configured destination, such as an SNS topic, SQS queue, or EventBridge. -AWS Lambda +AWS Lambda - Error Analysis ### Resource Usage -**AWS Lambda - Resource Usage** dashboard provides insights on recent AWS Lambda request details, memory usage trends, function duration, claimed concurrency, and compute usage. +The **AWS Lambda - Resource Usage** dashboard provides insights on recent AWS Lambda request details, memory usage trends, function duration, claimed concurrency, and compute usage. Use this dashboard to: * Monitor the memory usage pattern of a Lambda function during its execution. @@ -375,12 +344,12 @@ Use this dashboard to: * Monitor the compute usage by function. * Monitor claimed account concurrency at the account level, segmented by region. -AWS Lambda +AWS Lambda - Resource Usage ### Performance Trends -**AWS Lambda - Performance Trends** dashboard displays log data analytics to provide insights on memory usage, function duration, recent request details, and compute usage. +The **AWS Lambda - Performance Trends** dashboard displays log data analytics to provide insights on memory usage, function duration, recent request details, and compute usage. Use this dashboard to: * Monitor concurrent executions of an AWS Lambda function and understand trends over time. @@ -388,15 +357,43 @@ Use this dashboard to: * Monitor memory used by AWS Lambda functions. * Monitor compute usage trends and predictions by AWS Lambda function in GB-Seconds. -AWS Lambda +AWS Lambda - Performance Trends ### Threat Intel -**AWS Lambda - Threat Intel** dashboard provides insights into incoming requests to your AWS Lambda functions from malicious sources determined via Sumo Logic [threat intelligence](/docs/security/threat-intelligence/). Panels show detailed information on malicious IPs and the malicious confidence of each threat. +The **AWS Lambda - Threat Intel** dashboard provides insights into incoming requests to your AWS Lambda functions from malicious sources determined via Sumo Logic [threat intelligence](/docs/security/threat-intelligence/). Panels show detailed information on malicious IPs and the malicious confidence of each threat. Use this dashboard to: * Identify known malicious IPs that are accessing your load-balancers and use firewall access control lists to prevent them from sending you traffic going forward * Monitor the malicious confidence level for all incoming malicious IP address threats. -AWS Lambda +AWS Lambda - Threat Intel + + +## Create monitors for AWS Lambda app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### AWS Lambda alerts + +| Alert Name | Alert Description and Conditions | Alert Condition | Recover Condition | +|:--|:--|:--|:--| +| `AWS Lambda - High Memory Utilization` | This alert fires when we detect a Lambda execution with memory usage of more than 85% within an interval of 10 minutes. | Count > 0 | Count <= 0 | +| `AWS Lambda - High Percentage of Failed Requests` | This alert fires when we detect a large number of failed Lambda requests (>5%) within an interval of 5 minutes. | Count >= 5 | Count < 5 | +| `AWS Lambda - Low Provisioned Concurrency Utilization` | This alert fires when the average provisioned concurrency utilization for 5 minutes is low (<= 50%). This indicates low provisioned concurrency utilization efficiency. | Count <= 50 | Count > 50 | +| `AWS Lambda - Throttling` | This alert fires when we detect a Lambda running into throttling within an interval of 10 minutes. | Count > 0 | Count <= 0 | + +## Upgrade/Downgrade the AWS API Gateway app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS API Gateway app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + \ No newline at end of file diff --git a/docs/integrations/amazon-aws/network-load-balancer.md b/docs/integrations/amazon-aws/network-load-balancer.md index 213460afd2..e41ced2b15 100644 --- a/docs/integrations/amazon-aws/network-load-balancer.md +++ b/docs/integrations/amazon-aws/network-load-balancer.md @@ -50,56 +50,29 @@ When you create an AWS Source, you'll need to identify the Hosted Collector you Namespace for AWS Network Load Balancer Service is AWS/NetworkELB. ::: -## Field in field schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the “**networkloadbalancer**” field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields.md#manage-fields). - -## Field Extraction Rule(s) - -Create a Field Extraction Rule for AWS Network Load Balancer Cloudtrail Logs. Learn how to create Field Extraction Rule [here](/docs/manage/field-extractions/create-field-extraction-rule). +## Installing the AWS Network Load Balancer app -**AWS Network Load Balancer CloudTrail Logs** -```sql -Rule Name: AwsObservabilityNLBCloudTrailLogsFER -Applied at: Ingest Time -Scope (Specific Data): account=* eventSource eventName "elasticloadbalancing.amazonaws.com" "2015-12-01" -``` +Now that you have set up a collection for **AWS Network Load Balancer**, install the Sumo Logic app to use the pre-configured dashboards that provide visibility into your environment for real-time analysis of overall usage. -```sumo title="Parse Expression" -json "eventSource", "awsRegion", "recipientAccountId", "requestParameters.name", "requestParameters.type", "requestParameters.loadBalancerArn", "requestParameters.listenerArn", "apiVersion" as event_source, region, accountid, networkloadbalancer, loadbalancertype, loadbalancerarn, listenerarn, api_version nodrop -| where event_source = "elasticloadbalancing.amazonaws.com" and api_version matches "2015-12-01" -| "" as namespace -| parse field=loadbalancerarn ":loadbalancer/*/*/*" as balancertype1, networkloadbalancer1, f1 nodrop -| parse field=listenerarn ":listener/*/*/*/*" as balancertype2, networkloadbalancer2, f1, f2 nodrop -| if(loadbalancertype matches "network", "aws/networkelb", if(balancertype1 matches "net", "aws/networkelb", if(balancertype2 matches "net", "aws/networkelb", namespace))) as namespace -| if(loadbalancertype matches "application", "aws/applicationelb", if(balancertype1 matches "app", "aws/applicationelb", if(balancertype2 matches "app", "aws/applicationelb", namespace))) as namespace -| where namespace="aws/networkelb" or isEmpty(namespace) -| if (!isEmpty(networkloadbalancer), networkloadbalancer, if (!isEmpty(networkloadbalancer1), networkloadbalancer1, networkloadbalancer2)) as networkloadbalancer -| toLowerCase(networkloadbalancer) as networkloadbalancer -| fields region, namespace, networkloadbalancer, accountid -``` +import AppInstall from '../../reuse/apps/app-install-v2.md'; -## Metric rules + -Create the following Metric Rule for the AWS/NetworkELB namespace if not already created. Learn how to create a Metrics Rule [here](/docs/metrics/metric-rules-editor#create-a-metrics-rule). +As part of the app installation process, the following fields will be created by default: -```sql title="Rule 1*" -Rule name: AwsObservabilityNLBMetricsAddonEntityRule -Metric match expression: Namespace=AWS/NetworkELB LoadBalancer=* -Variable name: networkloadbalancer -Tag sequence: $LoadBalancer._1 -Save it -``` +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for AWS Network Load Balancer Service is AWS/NetworkELB. +- `networkloadbalancer` Network Load Balancer name. -## Installing the AWS Network Load Balancer app +## Field Extraction Rule(s) -Now that you have set up a collection for **AWS Network Load Balancer**, install the Sumo Logic app to use the pre-configured dashboards that provide visibility into your environment for real-time analysis of overall usage. +The FER **AwsObservabilityNLBCloudTrailLogsFER** to extract fields `region`, `namespace`, `accountid`, and `networkloadbalancer` will be created as a part of app installation. -import AppInstall from '../../reuse/apps/app-install.md'; +## Metric rule(s) - +The Metric Rule **AwsObservabilityNLBMetricsRule** for the AWS/NetworkELB namespace will be created as a part of app installation. ## Viewing AWS Network Load Balancer dashboards @@ -109,21 +82,21 @@ import FilterDashboards from '../../reuse/filter-dashboards.md'; ### Overview -The **The AWS Network Load Balancer - Overview** dashboard provides detailed insights into a view of network utilization and performance. The dashboard provides information about the errors, health, and traffic handled by the load balancer. +The **AWS Network Load Balancer - Overview** dashboard provides detailed insights into a view of network utilization and performance. The dashboard provides information about the errors, health, and traffic handled by the load balancer. Use this dashboard to: * Get an at-a-glance view of the number of errors and status of backend hosts. * Identify load balancers with the most number of unhealthy hosts. * Monitor trends around active connections, bytes processed, and reset packets to ensure load balancers are operating as expected. -AWS Network Load Balancer dashboards +AWS Network Load Balancer - Overview ### Active and New Flows The **AWS Network Load Balancer - Active and New Flows** dashboard provides detailed insights for new flows, and active flows for TCP, TLS, and UDP traffic. Use this dashboard to to monitor trends around active and new flows (connections) to make sure they line up with expectations, then use this information to scale up/scale down backend hosts. -AWS Network Load Balancer dashboards +AWS Network Load Balancer - Active and New Flows ### Host Health Status @@ -135,7 +108,7 @@ Use this dashboard to: * Get a quick overview of the number of healthy and unhealthy hosts. * Monitor trends around the number of unhealthy hosts to spot potential service disruptions that could warrant deeper investigation. -AWS Network Load Balancer dashboards +AWS Network Load Balancer - Host Health Status ### Errors @@ -145,7 +118,7 @@ Use this dashboard to: * Monitor TLS handshake errors during negotiation between a client and a TLS listener, which could happen if clients are sending an incorrect cipher or are using incorrect protocols not matching the one specified in the security policy. It’s recommended to use the most recent AWS CLI client version. * Monitor TLS handshake errors during negotiation between a TLS listener and a target. Possible causes for this error include a mismatch of ciphers or protocols. -AWS Network Load Balancer dashboards +AWS Network Load Balancer - Errors ### Reset (RST) Packets @@ -154,14 +127,14 @@ The **AWS Network Load Balancer - Reset (RST) Packets** dashboard provides detai Use this dashboard to monitor the number of RST packets. A high number of reset packets could indicate connections are getting dropped and could mean a disruption in service. -AWS Network Load Balancer dashboards +AWS Network Load Balancer - Reset (RST) Packets ### Processed Bytes The **AWS Network Load Balancer - Processed Bytes** dashboard provides detailed insights into the amount of bytes processed by the load balancer for total, UDP, TCP and TLS traffic. Use this dashboard to monitor trends around processed bytes to make sure they line up with expectations and then use that information to scale up or scale down backend hosts. -AWS Network Load Balancer dashboards +AWS Network Load Balancer - Processed Bytes ### Consumed LCUs @@ -172,7 +145,7 @@ The **AWS Network Load Balancer - Consumed LCUs** dashboard shows you the total You pay for the number of LCUs that you use per hour. ::: -AWS Network Load Balancer dashboards +AWS Network Load Balancer - Consumed LCUs ### CloudTrail Audit @@ -184,4 +157,34 @@ Use this dashboard to: * Investigate specific error events, including their details, frequency, and associated users, enabling faster troubleshooting and resolution of issues. * Identify the most common error types and the users experiencing highest failure rates, facilitating targeted improvements and user support. -AWS Network Load Balancer dashboards +AWS Network Load Balancer - CloudTrail Audit + +## Create monitors for AWS Network Load Balancer app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### AWS Network Load Balancer alerts + +These alerts are available for the AWS Network Load Balancer app. + +| Alert Name | Alert Description and Conditions | Alert Condition | Recover Condition | +|:--|:--|:--|:--| +| `AWS Network Load Balancer - Deletion Alert` | This alert fires when we detect greater than or equal to 2 network load balancers are deleted over a 5 minute time-period. | Count >= 2 | Count < 2 | +| `AWS Network Load Balancer - High TLS Negotiation Errors` | This alert fires when we detect that there are too many TLS Negotiation Errors (>=10%) within an interval of 5 minutes for a given network load balancer. | Percentage >= 10% | Percentage < 10% | +| `AWS Network Load Balancer - High Unhealthy Hosts` | This alert fires when we detect that there are too many unhealthy hosts (>=10%) within an interval of 5 minutes for a given network load balancer. | Percentage >= 10% | Percentage < 10% | +| `AWS Network Load Balancer - Targets Deregistered` | This alert fires when we detect greater than or equal to 1 target is de-registered over a 5 minute time-period. | Count >= 1 | Count < 1 | + + +## Upgrade/Downgrade the AWS API Gateway app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS API Gateway app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + diff --git a/docs/integrations/amazon-aws/rds.md b/docs/integrations/amazon-aws/rds.md index e105ebc9d6..5d3c248d63 100644 --- a/docs/integrations/amazon-aws/rds.md +++ b/docs/integrations/amazon-aws/rds.md @@ -424,38 +424,6 @@ Sumo Logic supports several methods for collecting logs from Amazon CloudWatch. Fields -### Field in Field Schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the `dbidentifier`, `proxyname` fields. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields#manage-fields). - -### Field Extraction Rule(s) - -Create a Field Extraction Rule for CloudTrail Logs. Learn how to create a Field Extraction Rule [here](/docs/manage/field-extractions/create-field-extraction-rule). - -```sql -Rule Name: AwsObservabilityRdsCloudTrailLogsFER -Applied at: Ingest Time -Scope (Specific Data): account=* eventname eventsource "rds.amazonaws.com" -``` - -```sumo title="Parse Expression" -| json "eventSource", "awsRegion", "requestParameters", "responseElements", "recipientAccountId" as eventSource, region, requestParameters, responseElements, accountid nodrop -| where eventSource = "rds.amazonaws.com" | "aws/rds" as namespace -| json field=requestParameters "dBInstanceIdentifier", "resourceName", "dBClusterIdentifier", "dBProxyName" as dBInstanceIdentifier1, resourceName, dBClusterIdentifier1, dBProxyName1 nodrop -| json field=responseElements "dBInstanceIdentifier", "dBClusterIdentifier", "dBProxy.dBProxyName", "dBProxyTargetGroup.dBProxyName" as dBInstanceIdentifier3, dBClusterIdentifier3, dBProxyName2, dBProxyName3 nodrop -| parse field=resourceName "arn:aws:rds:*:db:*" as f1, dBInstanceIdentifier2 nodrop -| parse field=resourceName "arn:aws:rds:*:cluster:*" as f1, dBClusterIdentifier2 nodrop -| if (resourceName matches "arn:aws:rds:*:db:*", dBInstanceIdentifier2, if (!isEmpty(dBInstanceIdentifier1), dBInstanceIdentifier1, dBInstanceIdentifier3) ) as dBInstanceIdentifier -| if (resourceName matches "arn:aws:rds:*:cluster:*", dBClusterIdentifier2, if (!isEmpty(dBClusterIdentifier1), dBClusterIdentifier1, dBClusterIdentifier3) ) as dBClusterIdentifier -| if (isEmpty(dBInstanceIdentifier), dBClusterIdentifier, dBInstanceIdentifier) as dbidentifier -| tolowercase(dbidentifier) as dbidentifier -| if (!isEmpty(dBProxyName1), dBProxyName1, if (!isEmpty(dBProxyName2), dBProxyName2, dBProxyName3)) as proxyname -| tolowercase(proxyname) as proxyname -| fields region, namespace, dBInstanceIdentifier, dBClusterIdentifier, dbidentifier, proxyname, accountid -``` - ### Centralized AWS CloudTrail log collection In case you have a centralized collection of CloudTrail logs and are ingesting them from all accounts into a single Sumo Logic CloudTrail log source, create the following Field Extraction Rule to map a proper AWS account(s) friendly name/alias. Create it if not already present / update it as required. @@ -479,59 +447,34 @@ Enter a parse expression to create an “account” field that maps to the alias | fields account ``` -#### Create/Update Field Extraction Rule(s) for RDS CloudWatch logs +## Installing the RDS app +Now that you have set up a collection for **Amazon RDS**, install the Sumo Logic app to use the pre-configured [dashboards](#viewing-the-rds-dashboards) that provide visibility into your environment for real-time analysis of overall usage. -``` -Rule Name: AwsObservabilityGenericCloudWatchLogsFER -Applied at: Ingest Time -Scope (Specific Data): -account=* region=* (_sourceHost=/aws/* or _sourceHost=API*Gateway*Execution*Logs*) -Parse Expression: -if (isEmpty(namespace),"unknown",namespace) as namespace -| if (_sourceHost matches "/aws/lambda/*", "aws/lambda", namespace) as namespace -| if (_sourceHost matches "/aws/rds/*", "aws/rds", namespace) as namespace -| if (_sourceHost matches "/aws/ecs/containerinsights/*", "aws/ecs", namespace) as namespace -| if (_sourceHost matches "/aws/kinesisfirehose/*", "aws/firehose", namespace) as namespace -| if (_sourceHost matches "/aws/apigateway/*", "aws/apigateway", namespace) as namespace -| if (_sourceHost matches "API-Gateway-Execution-Logs*", "aws/apigateway", namespace) as namespace -| parse field=_sourceHost "/aws/lambda/*" as functionname nodrop | tolowercase(functionname) as functionname -| parse field=_sourceHost "/aws/rds/proxy/*" as proxyname nodrop -| parse field=_sourceHost "/aws/rds/instance/*/" as dbidentifier nodrop -| parse field=_sourceHost "/aws/rds/cluster/*/" as dbidentifier nodrop -| parse field=_sourceHost "/aws/apigateway/*/*" as apiid, stage nodrop -| parse field=_sourceHost "API-Gateway-Execution-Logs_*/*" as apiid, stage nodrop | apiid as apiName -| tolowercase(dbidentifier) as dbidentifier -| fields namespace, functionname, proxyname, dbidentifier, apiid, apiName -``` +import AppInstall from '../../reuse/apps/app-install-v2.md'; -### Metric Rules + -Create the following two Metric Rules for the aws/rds namespace if not already created. Learn how to create a Metrics Rule [here](/docs/metrics/metric-rules-editor#create-a-metrics-rule). +As part of the app installation process, the following fields will be created by default: -```sql title="Rule 1" -Rule name: AwsObservabilityRDSClusterMetricsEntityRule -Metric match expression: Namespace=AWS/RDS DBClusterIdentifier=* -Variable name: dbidentifier -Tag sequence: $DBClusterIdentifier._1 -Save it -``` +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for Amazon RDS service is aws/rds. +- `dbidentifier` The RDS database instance identifier. +- `dBInstanceIdentifier` The identifier of the RDS DB instance. +- `dBClusterIdentifier` The identifier of the RDS DB cluster. +- `proxyname` The name of the RDS Proxy. -```sql title="Rule 2" -Rule name: AwsObservabilityRDSInstanceMetricsEntityRule -Metric match expression: Namespace=AWS/RDS DBInstanceIdentifier=* -Variable name: dbidentifier -Tag sequence: $DBInstanceIdentifier._1 -Save it -``` +### Field Extraction Rule(s) -## Installing the RDS app +The FER **AwsObservabilityRDSCloudTrailLogsFER** to extract fields `region`, `namespace`, `dBInstanceIdentifier`, `dBClusterIdentifier`, `dbidentifier`, `proxyname`, and `accountid` will be created as a part of app installation. -Now that you have set up a collection for **Amazon RDS**, install the Sumo Logic app to use the pre-configured [dashboards](#viewing-the-rds-dashboards) that provide visibility into your environment for real-time analysis of overall usage. +The FER **AwsObservabilityRDSCloudWatchLogsFER** to extract fields `namespace`, `dbidentifier`, and `proxyname` will be created as a part of app installation. -import AppInstall from '../../reuse/apps/app-install.md'; +### Metric Rules - +The Metric Rules **AwsObservabilityRDSClusterMetricsRule** and **AwsObservabilityRDSInstanceMetricsRule** for the aws/rds namespace will be created as a part of app installation. ## Viewing the RDS dashboards @@ -546,7 +489,7 @@ Use this dashboard to: * Quickly identify problems in resource utilization. * Monitor database performance insights such as relative CPU load, non-CPU load, and overall database load. -Amazon RDS dashboard +Amazon RDS - Overview ### CloudTrail Audit Events @@ -558,7 +501,7 @@ Use this dashboard to: * Monitor the most active users working on RDS infrastructure, database engines used in the infrastructure, and various events invoked on RDS clusters. * Monitor requests from malicious IP addresses using Sumo Logic’s Threat Intel. -Amazon RDS dashboard +Amazon RDS - CloudTrail Audit Events ### Non-Describe CloudTrail Audit Events @@ -570,7 +513,7 @@ Use this dashboard to: * Monitor and track snapshot-related events performed on RDS instances. * Monitor and track changes to security groups associated with your RDS infrastructure. -Amazon RDS dashboard +Amazon RDS - Non-Describe CloudTrail Audit Events ### Overview By Database Instance @@ -580,7 +523,7 @@ Use this dashboard to: * Quickly identify performance or resource utilization issues in your RDS clusters. * Monitor resource utilization with trend panels for CPU usage, available memory, network receive and transmit throughput, read and write IOPS, available free storage, and database connections across your Amazon RDS clusters and database instances. -Amazon RDS dashboard +Amazon RDS - Overview By Database Instance ### Performance Insights @@ -591,7 +534,7 @@ Use this dashboard to: * Identify when the CPU is overloaded, so you can throttle connections to the instance, tune SQL queries with a high CPU load, or consider a larger instance class to remedy the situation. * Identify high and consistent instances of any wait state (Non-CPU Load) that indicate potential bottlenecks or resource contention issues that need to be resolved, which can be an issue even when the load doesn't exceed maximum CPU. -Amazon RDS dashboard +Amazon RDS - Performance Insights ### 03. Amazon RDS Aurora Generic @@ -604,7 +547,7 @@ Use this dashboard to: * Monitor the amount of storage used to ensure monitoring costs. * Monitor the percentage of requests that are served by the buffer cache to identify potential performance optimizations. -Amazon RDS dashboard +Amazon RDS - Aurora Generic ### Aurora MySQL @@ -617,7 +560,7 @@ Use this dashboard to: * Monitor replica lag between Aurora DB clusters that are replicating across different AWS Regions. * Monitor the number of login failures to the database for security monitoring. -Amazon RDS dashboard +Amazon RDS - Aurora MySQL ### Aurora MySQL Global Database and BackTrack Activity @@ -631,7 +574,7 @@ Use this dashboard to: * Monitor the amount of redo log data that is transferred from the master AWS region to secondary AWS regions. * Monitor the number of write I/O operations replicated from the primary AWS region to the cluster volume in a secondary AWS region in an Aurora Global Database. The billing calculations for the primary AWS region in a global database use AuroraGlobalDBReplicatedWriteIO to account for cross-region replication within the global database. -Amazon RDS dashboard +Amazon RDS - Aurora MySQL Global Database and Backtrack Activity ### MySQL Logs - Overview @@ -643,7 +586,7 @@ Use this dashboard to: * Get the number of failed and successful DB connections. * Get a quick breakdown of the protocol used for database connections. -Amazon RDS dashboard +Amazon RDS - MySQL Logs Overview ### MySQL Logs - Error Logs Analysis @@ -656,7 +599,7 @@ Use this dashboard to: * Monitor database instances starting up and being ready for connection events. * Monitor MySQL RDS Cluster replication events. -Amazon RDS dashboard +Amazon RDS - MySQL Logs Error Logs Analysis ### MySQL Logs - Slow Query Analysis @@ -670,7 +613,7 @@ Use this dashboard to: * Check if **SQL SELECT** type queries can be shifted to read replicas for better performance. * Monitor trends of slow queries and compare them with history to check if something different is happening or might have happened to decide the next step. -Amazon RDS dashboard +Amazon RDS - MySQL Logs Slow Query Analysis ### MySQL Logs - Audit Logs Analysis @@ -685,7 +628,7 @@ Use this dashboard to: * Identify typical user management activities being performed. * Quickly identify objects that are dropped. -Amazon RDS dashboard +Amazon RDS - MySQL Logs Audit Log Analysis ### MySQL Logs - Audit Log SQL Statements @@ -695,7 +638,7 @@ Use this dashboard to: * Identify the top SQL statements and commands being executed, along with trends. * Get details on various SQL statements/commands (DML, DDL, DCL, TCL) being executed. -Amazon RDS dashboard +Amazon RDS - MySQL Logs Audit Log SQL Statements ### MySQL Logs - General Log Analysis @@ -707,7 +650,7 @@ Use this dashboard to: * Monitor why certain things are failing by checking what exactly the client sent to the server to execute. * Monitor the type of SQL statements/queries (DML, DDL, DCL, TCL, and others) being sent by the client to execute. -Amazon RDS dashboard +Amazon RDS - MySQL Logs General Log Analysis ### PostgreSQL Logs - Overview @@ -719,7 +662,7 @@ Use this dashboard to: * Obtain user activity and query execution by the database. * Obtain the slow queries count and distribution based on user, command type, and host. -Amazon RDS dashboard +Amazon RDS - PostgreSQL Logs Overview ### PostgreSQL Logs - Errors @@ -731,7 +674,7 @@ Use this dashboard to: * Obtain recent and top fatal and error events. * Obtain recent queries running into error with the error message. -Amazon RDS dashboard +Amazon RDS - PostgreSQL Logs Errors ### PostgreSQL Logs - Slow Query Overview @@ -744,7 +687,7 @@ Use this dashboard to: * Obtain unique slow queries along with execution time, analysing minimum, maximum, average, and many more. * Obtain the time comparison between the number of slow queries and their execution time over 1 day or 1 week. -Amazon RDS dashboard +Amazon RDS - PostgreSQL Logs Slow Query Overview ### PostgreSQL Logs - Slow Query Details @@ -755,7 +698,7 @@ Use this dashboard to: * Obtain the frequently fired slow queries. * Monitor the recent DML, DDL, and TCL statements that lead to slow queries. -Amazon RDS dashboard +Amazon RDS - PostgreSQL Logs Slow Query Details ### PostgreSQL Logs - Security @@ -767,7 +710,7 @@ Use this dashboard to: * Monitor database shutdown and system up events. * Identify the default user's authentication and generic activities. -Amazon RDS dashboard +Amazon RDS - PostgreSQL Logs Security ### PostgreSQL Logs - Query Execution Time @@ -777,7 +720,7 @@ Use this dashboard to: * Obtain the number of queries executed and average query execution time by database. * Monitor time comparison for the number of queries executed and query execution time. -Amazon RDS dashboard +Amazon RDS - PostgreSQL Logs Query Execution Time ### MSSQL Logs - Error Logs - Logon Analysis @@ -787,7 +730,7 @@ Use this dashboard to: * Identify the authentication failures along with the reason for the user and client location that are used to connect. * Detect logon errors, including error codes, severity levels, and states. -Amazon RDS dashboard +Amazon RDS - MSSQL Logs Error Logs Logon Analysis ### MSSQL Logs - Error Logs - Infrastructure Overview @@ -799,7 +742,7 @@ Use this dashboard to: * Monitors `DBCC CHECKDB` checks. * Track recent terminations of SQL Server instances and monitor the creation of new databases. -Amazon RDS dashboard +Amazon RDS - MSSQL Logs Error Logs Infrastructure Overview ### Oracle Logs - Alert Logs Analysis @@ -810,7 +753,7 @@ Use this dashboard to: * Monitor ORA and TNS message events. * Monitor log switch activities, archival errors, tablespace extension issues, failures, warnings, and errors occurring on the Oracle RDS instance. -Amazon RDS dashboard +Amazon RDS - Oracle Logs Alert Logs Analysis ### Oracle Logs - Audit Logs Analysis @@ -820,7 +763,7 @@ Use this dashboard to: * Monitor successful and failed Amazon Oracle RDS events. * Monitor top usage by client, database user, and privileges on the Oracle RDS instance. -Amazon RDS dashboard +Amazon RDS - Oracle Logs Audit Logs Analysis ### Oracle Logs - Listener Troubleshooting @@ -831,7 +774,7 @@ Use this dashboard to: * Monitor listener process activity on the Oracle RDS instance. * Monitor database connections by host and application, track connection failures, analyze command execution statuses and trends, and gather insights from the Oracle Listener log. -Amazon RDS dashboard +Amazon RDS - Oracle Logs Listener Troubleshooting ## Viewing the RDS Proxy dashboards @@ -843,7 +786,7 @@ Use this dashboard to: * Monitor RDS Proxy availability and connection pool usage. * Track client and database connection metrics, including connection limits, Latency, and usage trends, to optimize performance and troubleshoot connectivity issues. -Amazon RDS dashboard +Amazon RDS - Proxy Overview ### Proxy - Client Connection Endpoint Performance @@ -855,7 +798,7 @@ Use this dashboard to: * Analyze connection setup latency and performance trends. * Gain insights into how applications interact with the database via the proxy to identify potential bottlenecks or security issues. -Amazon RDS dashboard +Amazon RDS - Proxy Client Connection Endpoint Performance ### Proxy - Query Endpoint Performance @@ -867,7 +810,7 @@ Use this dashboard to: * Analyze query response latency to identify performance issues. * Optimize database performance by evaluating proxy-handled query behavior. -Amazon RDS dashboard +Amazon RDS - Proxy Query Endpoint Performance ### Proxy - Target Performance @@ -879,7 +822,7 @@ Use this dashboard to: * Analyze transaction behavior and connection health. * Optimize performance and ensure reliable proxy-to-database interactions. -Amazon RDS dashboard +Amazon RDS - Proxy Target Performance ### Proxy - TargetRole Performance @@ -890,7 +833,7 @@ Use this dashboard to: * Analyze transaction behavior and connection health. * Optimize performance and ensure reliable proxy-to-database interactions. -Amazon RDS dashboard +Amazon RDS - Proxy TargetRole Performance ### Proxy - Audit @@ -902,7 +845,7 @@ Use this dashboard to: * Identify the most active proxies. * Gain visibility into changes and audit trail for proxy-managed database interactions. -Amazon RDS dashboard +Amazon RDS - Proxy Audit ### Proxy - Log Analysis @@ -914,4 +857,48 @@ Use this dashboard to: * Identify authentication issues, failures, and database availability problems. * Troubleshoot proxy operations effectively using log insights. -Amazon RDS dashboard +Amazon RDS - Proxy Log Analysis + +## Create monitors for Amazon RDS app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### Amazon RDS alerts + +These alerts are available for the Amazon RDS app. + +| Alert Name | Alert Description and Conditions | Alert Condition | Recover Condition | +|:--|:--|:--|:--| +| `Amazon RDS - High CPU Utilization` | This alert fires when we detect that the average CPU utilization for a database is high (>=85%) for an interval of 5 minutes. | Percentage >= 85% | Percentage < 85% | +| `Amazon RDS - High Disk Queue Depth` | This alert fires when the average disk queue depth for a database is high (>=5) for an interval of 5 minutes. Higher this value, higher will be the number of outstanding I/Os (read/write requests) waiting to access the disk, which will impact the performance of your application. | Count >= 5 | Count < 5 | +| `Amazon RDS - High Read Latency` | This alert fires when the average read latency of a database within a 5 minutes time interval is high (>=5 seconds). High read latency will affect the performance of your application. | Seconds >= 5 | Seconds < 5 | +| `Amazon RDS - High Write Latency` | This alert fires when the average write latency of a database within a 5 minute interval is high (>=5 seconds). High write latencies will affect the performance of your application. | Seconds >= 5 | Seconds < 5 | +| `Amazon RDS - Low Aurora Buffer Cache Hit Ratio` | This alert fires when the average RDS Aurora buffer cache hit ratio within a 5 minute interval is low (<= 50%). This indicates that a lower percentage of requests were served by the buffer cache, which could further indicate a degradation in application performance. | Percentage <= 50% | Percentage > 50% | +| `Amazon RDS - Low Burst Balance` | This alert fires when we observe a low burst balance (<= 50%) for a given database. A low burst balance indicates you won't be able to scale up as fast for burstable database workloads on gp2 volumes. | Percentage <= 50% | Percentage > 50% | +| `Amazon RDS - Low Free Storage` | This alert fires when the average free storage space of a RDS instance is low (< 512MB) for an interval of 15 minutes. | MB < 512 | MB >= 512 | +| `Amazon RDS - Low Freeable Memory` | This alert fires when the average Freeable memory of an RDS instance is < 128 MB for an interval of 15 minutes. If this value is lower you may need to scale up to a larger instance class. | MB <= 128 | MB > 128 | +| `Amazon RDS MSSQL - Authentication failures from the same client IP on multiple databases` | This alert fires when we detect a specific client IP attempting authentication failures on more than or equal to 10 databases over a 15 minute time-period. | Count >= 1 | Count < 1 | +| `Amazon RDS MSSQL - Database observing authentication failures from multiple client IPs` | This alert fires when we detect more than or equal to 10 client IPs attempting authentication failures on the database over a 15-minute period. | Count >= 1 | Count < 1 | +| `Amazon RDS MySQL - Excessive Slow Query Detected` | This alert fires when we detect the average time to execute a query is more than 5 seconds over last 10 minutes. | Count >= 1 | Count < 1 | +| `Amazon RDS MySQL - High Authentication Failure` | This alert fires when we detect more than 10 authentication failures over a 5 minute time-period. | Count > 10 | Count <= 10 | +| `Amazon RDS - Oracle Logs - DB Crash` | This alert fires when we detect greater than or equal to 1 Oracle DB crash over a 5 minute time-period. | Count >= 1 | Count < 1 | +| `Amazon RDS - Oracle Logs - Failed Connection Attempts` | This alert fires when we detect greater than or equal to 25 failed connection attempts over a 5 minute time-period. | Count >= 25 | Count < 25 | +| `Amazon RDS PostgreSQL - Excessive Slow Query Detected` | This alert fires when we detect the average time to execute a query is more than 5 seconds over a 10 minutes. | Count > 0 | Count <= 0 | +| `Amazon RDS PostgreSQL - High Authentication Failure` | This alert fires when we detect more than 10 authentication failures in Postgres logs over a 5 minute time-period. | Count > 10 | Count <= 10 | +| `Amazon RDS PostgreSQL - High Errors` | This alert fires when we detect high number (>10) of error/fatal logs in Postgres logs over a 5 minutes time period. | Count > 10 | Count <= 10 | +| `Amazon RDS PostgreSQL - Statement Timeouts` | This alert fires when we detect Postgres logs show statement timeouts. | Count > 0 | Count <= 0 | +| `Amazon RDS - Unencrypted RDS resources created` | This alert fires when an CreateDBCluster or CreateDBInstance CloudTrail event is detected where StorageEncrypted is not set to true, indicating an unencrypted RDS resource was created. | Count >= 1 | Count < 1 | + +## Upgrade/Downgrade the AWS API Gateway app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS API Gateway app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + diff --git a/docs/integrations/amazon-aws/sns.md b/docs/integrations/amazon-aws/sns.md index a4d9504ea1..d349030cbb 100644 --- a/docs/integrations/amazon-aws/sns.md +++ b/docs/integrations/amazon-aws/sns.md @@ -103,42 +103,6 @@ account={{account}} region={{region}} namespace={{namespace}} TopicName={{topicn * **Enable Multiline Processing**. Select the **Detect messages spanning multiple lines** check box, and select **Infer Boundaries**. 2. Click **Save**. -### Field in Field Schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the `"topicname"` field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields#manage-fields). - -### Field Extraction Rule(s) - -Create a Field Extraction Rule for CloudTrail Logs. Learn how to create a Field Extraction Rule [here](/docs/manage/field-extractions/create-field-extraction-rule). - -```sql -Rule Name: AwsObservabilitySNSCloudTrailLogsFER -Applied at: Ingest Time -Scope (Specific Data): account=* eventname eventsource \"sns.amazonaws.com\" -``` - -**Parse Expression**: - -```sumo -| json "userIdentity", "eventSource", "eventName", "awsRegion", "recipientAccountId", "requestParameters", "responseElements" as userIdentity, event_source, event_name, region, recipient_account_id, requestParameters, responseElements nodrop -| where event_source = "sns.amazonaws.com" -| json field=userIdentity "accountId", "type", "arn", "userName" as accountid, type, arn, username nodrop -| parse field=arn ":assumed-role/*" as user nodrop -| parse field=arn "arn:aws:iam::*:*" as accountid, user nodrop -| json field=requestParameters "topicArn", "name", "resourceArn", "subscriptionArn" as req_topic_arn, req_topic_name, resource_arn, subscription_arn nodrop -| json field=responseElements "topicArn" as res_topic_arn nodrop -| if (isBlank(req_topic_arn), res_topic_arn, req_topic_arn) as topic_arn -| if (isBlank(topic_arn), resource_arn, topic_arn) as topic_arn -| parse field=topic_arn "arn:aws:sns:*:*:*" as region_temp, accountid_temp, topic_arn_name_temp nodrop -| parse field=subscription_arn "arn:aws:sns:*:*:*:*" as region_temp, accountid_temp, topic_arn_name_temp, arn_value_temp nodrop -| if (isBlank(req_topic_name), topic_arn_name_temp, req_topic_name) as topicname -| if (isBlank(accountid), recipient_account_id, accountid) as accountid -| "aws/sns" as namespace -| fields region, namespace, topicname, accountid -``` - ## Centralized AWS CloudTrail Log Collection In case, you have a centralized collection of CloudTrail logs and are ingesting them from all accounts into a single Sumo Logic CloudTrail log source, create the following **Field Extraction Rule** to map a proper AWS account(s) friendly name/alias. Create it if not already present or update it as required. @@ -160,10 +124,22 @@ In case, you have a centralized collection of CloudTrail logs and are ingesting Now that you have set up collection for Amazon SNS, install the Sumo Logic app to use the pre-configured searches and dashboards that provide visibility into your environment for real-time analysis of overall usage. -import AppInstall from '../../reuse/apps/app-install.md'; +import AppInstall from '../../reuse/apps/app-install-v2.md'; +As part of the app installation process, the following fields will be created by default: + +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for Amazon SNS service is aws/sns. +- `topicname` Amazon SNS a Topic Name. + +## Field Extraction Rule(s) + +The FER **AwsObservabilitySNSCloudTrailLogsFER** to extract fields `region`, `namespace`, `accountid`, and `topicname` will be created as a part of app installation. + ## Viewing Amazon SNS dashboards ### Overview @@ -176,7 +152,7 @@ The **Amazon SNS - Overview** dashboard provides insights across CloudTrail even * Monitor number of messages and messages by publish size. * Monitor delivered and failed notifications. -Amazon SNS +Amazon SNS - Overview ### Amazon SNS - Audit Events @@ -189,7 +165,7 @@ Use this dashboard to: * Monitor successful and error events with error code in detail. * Get details of active topic names and users of both successful and error events. -Amazon SNS +Amazon SNS - Audit Events ### Amazon SNS - Messages, Notifications @@ -203,7 +179,7 @@ Use this dashboard to: * Compare messages published and message size by today, yesterday, last week. * Compare notifications delivered and failed by today, yesterday, last week. -Amazon SNS +Amazon SNS - Messages, Notifications ### Amazon SNS - Threat Intel @@ -214,7 +190,7 @@ The **Amazon SNS - Threat Intel** dashboard provides insights across threat loca * Get details of threats by malicious confidence and malicious IPs. * Get details of all threats by IPs. -Amazon SNS +Amazon SNS - Threat Intel ### Amazon SNS - Audit Events Details @@ -225,4 +201,35 @@ Use this dashboard to: * Get all details of all subscription events. * Get details of all read only and non read only events. -Amazon SNS +Amazon SNS - Audit Events Details + +## Create monitors for AWS SNS app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### AWS SNS alerts + +These alerts are available for the AWS SNS app. + +| Alert Name | Alert Description and Conditions | Alert Condition | Recover Condition | +|:--|:--|:--|:--| +| `AWS SNS - Access from Highly Malicious Sources` | This alert fires when an Application AWS - SNS is accessed from highly malicious IP addresses within last 5 minutes. | Count > 0 | Count <= 0 | +| `AWS SNS - Failed Events` | This alert fires when an SNS app has high number of failed events (>5) within last 5 minutes. | Count > 5 | Count <= 5 | +| `AWS SNS - Failed Notifications` | This alert fires where there are many failed notifications (>=5) within an interval of 5 minutes. | Count > 2 | Count <= 2 | +| `AWS SNS - Notification to DLQ` | This alert fires when an SNS topic messages are moved to a dead-letter queue. | Count > 0 | Count <= 0 | +| `AWS SNS - Notification to DLQ Failure` | This alert fires when an SNS topic messages that couldn't be moved to a dead-letter queue. | Count > 0 | Count <= 0 | + + +## Upgrade/Downgrade the AWS API Gateway app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS API Gateway app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + \ No newline at end of file diff --git a/docs/integrations/amazon-aws/sqs.md b/docs/integrations/amazon-aws/sqs.md index 57c34e69a3..264655977a 100644 --- a/docs/integrations/amazon-aws/sqs.md +++ b/docs/integrations/amazon-aws/sqs.md @@ -126,34 +126,6 @@ Sumo Logic supports collecting metrics using two source types: * **Enable Multiline Processing**. Select the **Detect messages spanning multiple lines** check box, and select **Infer Boundaries**. 2. Click **Save**. -## Field in Field Schema - -1. [**New UI**](/docs/get-started/sumo-logic-ui). In the main Sumo Logic menu select **Data Management**, and then under **Logs** select **Fields**. You can also click the **Go To...** menu at the top of the screen and select **Fields**.
[**Classic UI**](/docs/get-started/sumo-logic-ui-classic). In the main Sumo Logic menu, select **Manage Data > Logs > Fields**. -1. Search for the `queuename` field. -1. If not present, create it. Learn how to create and manage fields [here](/docs/manage/fields/#manage-fields). - -## Field Extraction Rule(s) -Create a Field Extraction Rule for CloudTrail Logs. Learn how to create a Field Extraction Rule [here](/docs/manage/field-extractions/create-field-extraction-rule). - -* **Rule Name**: AwsObservabilitySQSCloudTrailLogsFER -* **Applied at**: Ingest Time -* **Scope (Specific Data)**: account=* eventname eventsource "sqs.amazonaws.com" -* **Parse Expression**: - -```sumo -json "userIdentity", "eventSource", "eventName", "awsRegion", "recipientAccountId", "requestParameters", "responseElements", "sourceIPAddress" as userIdentity, event_source, event_name, region, recipient_account_id, requestParameters, responseElements, src_ip nodrop -| json field=userIdentity "accountId", "type", "arn", "userName" as accountid, type, arn, username nodrop -| json field=requestParameters "queueUrl" as queueUrlReq nodrop -| json field=responseElements "queueUrl" as queueUrlRes nodrop -| where event_source="sqs.amazonaws.com" -| if(event_name="CreateQueue", queueUrlRes, queueUrlReq) as queueUrl -| parse regex field=queueUrl "(?[^\/]*$)" -| if (isBlank(recipient_account_id), accountid, recipient_account_id) as accountid -|! toLowerCase(queuename) as queuename -| "aws/sqs" as namespace -| fields region, namespace, queuename, accountid -``` - ## Centralized AWS CloudTrail Log Collection In case you have a centralized collection of CloudTrail logs and are ingesting them from all accounts into a single Sumo Logic CloudTrail log source, create the following **Field Extraction Rule** to map a proper AWS account(s) friendly name/alias. Create it if not already present/update it as required. @@ -176,10 +148,22 @@ In case you have a centralized collection of CloudTrail logs and are ingesting t Now that you have set up collection for Amazon SQS, install the Sumo Logic app to use the pre-configured dashboards that provide visibility into your environment for real-time analysis of overall usage. -import AppInstall from '../../reuse/apps/app-install.md'; +import AppInstall from '../../reuse/apps/app-install-v2.md'; +As part of the app installation process, the following fields will be created by default: + +- `account` Name / alias to the AWS account. +- `accountid` AWS account id. +- `region` The region to which the resource name belongs to. +- `namespace` Namespace for Amazon SQS Service is AWS/SQS. +- `queuename` Amazon SQS Service Queue Name. + +## Field Extraction Rule(s) + +The FER **AwsObservabilitySQSCloudTrailLogsFER** to extract fields `region`, `namespace`, `accountid`, and `queuename` will be created as a part of app installation. + ## Viewing Amazon SQS dashboards Amazon Simple Queue Service (Amazon SQS) is a fully managed message queuing service that makes it easy to decouple and scale microservices, distributed systems, and serverless applications. @@ -231,3 +215,45 @@ Use this dashboard to: * Get details of all threats by IPs. 3. Amazon SQS - Threat Intel + +### Performance Trends + +The **1. Amazon SQS - Performance Trends** dashboard provides derived performance insights including true consumer lag, empty receive rate trends, and cross-queue rankings by backlog and message staleness. + +Use this dashboard to: +* Monitor true consumer lag by tracking combined visible and delayed messages in the backlog. +* Identify queues with high empty receive rates to optimize polling behavior and reduce costs. +* Rank queues by consumer backlog size to prioritize capacity planning. +* Identify message staleness risks by tracking the age of the oldest message per queue. + +1. Amazon SQS - Performance Trends + +## Create monitors for AWS SQS app + +import CreateMonitors from '../../reuse/apps/create-monitors.md'; + + + +### AWS SQS alerts + +These alerts are available for the AWS SQS app. + +| Alert Name | Alert Description and Conditions | Alert Condition | Recover Condition | +|:--|:--|:--|:--| +| `AWS SQS - Access from Highly Malicious Sources` | This alert fires when an Application AWS - SQS is accessed from highly malicious IP addresses within last 5 minutes. | Count > 0 | Count <= 0 | +| `AWS SQS - Message processing not fast enough` | This alert fires when we detect message processing is not fast enough. That is, the average approximate age of the oldest non-deleted message in the queue is more than 5 seconds for an interval of 5 minutes. | Seconds > 5 | Seconds <= 5 | +| `AWS SQS - Messages not processed` | This alert fires when we detect messages that have been received by a consumer, but have not been processed (deleted/failed). That is, the average number of messages that are in flight are >=20 for an interval of 5 minutes. | Count >= 20 | Count < 20 | +| `AWS SQS - Queue has stopped receiving messages` | This alert fires when we detect that the queue has stopped receiving messages. That is, the average number of messages received in the queue <1 for an interval of 30 minutes. | Count < 1 | Count >= 1 | + + +## Upgrade/Downgrade the AWS API Gateway app (Optional) + +import AppUpdate from '../../reuse/apps/app-update.md'; + + + +## Uninstalling the AWS API Gateway app (Optional) + +import AppUninstall from '../../reuse/apps/app-uninstall.md'; + + \ No newline at end of file diff --git a/sidebars.ts b/sidebars.ts index d1b757a8b7..f7c644a769 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -2153,6 +2153,7 @@ integrations: [ collapsed: true, link: {type: 'doc', id: 'integrations/amazon-aws/index'}, items: [ + 'integrations/amazon-aws/amazon-overview', 'integrations/amazon-aws/amazon-appflow', 'integrations/amazon-aws/amazon-appstream2', 'integrations/amazon-aws/amazon-athena', diff --git a/static/img/integrations/amazon-aws/Amazon-Overview-AWS-Account-Overview.png b/static/img/integrations/amazon-aws/Amazon-Overview-AWS-Account-Overview.png new file mode 100644 index 0000000000..7c22989358 Binary files /dev/null and b/static/img/integrations/amazon-aws/Amazon-Overview-AWS-Account-Overview.png differ diff --git a/static/img/integrations/amazon-aws/Amazon-Overview-AWS-Region-Overview.png b/static/img/integrations/amazon-aws/Amazon-Overview-AWS-Region-Overview.png new file mode 100644 index 0000000000..f18b6ed9b0 Binary files /dev/null and b/static/img/integrations/amazon-aws/Amazon-Overview-AWS-Region-Overview.png differ diff --git a/static/img/integrations/amazon-aws/amazon-overview.png b/static/img/integrations/amazon-aws/amazon-overview.png new file mode 100644 index 0000000000..b3e069a749 Binary files /dev/null and b/static/img/integrations/amazon-aws/amazon-overview.png differ