Getting Started with Host Monitoring

The AWS Infrastructure Explorer integration enables Coralogix to retrieve metadata for all your AWS resources from your AWS account and present it within the Coralogix Infrastructure Explorer.

Overview

Managing cloud resources and troubleshooting issues can be challenging, especially when they span multiple clouds and regions. Often, critical information, such as infrastructure metadata, logs, metrics, and alerts, comes from various sources and can be difficult to access or analyze.

The Coralogix Infrastructure Explorer seamlessly integrates with AWS to pull resource metadata and links it to Coralogix data for each resource (logs, metrics, traces, etc.), offering a unified, single-pane view.

Poll intervals

Currently, the poll interval for AWS infrastructure explorer integration defaults to 10 minutes and does not need to be changed.

Benefits

• Improved troubleshooting. With AWS resource metadata and related data all available within the Coralogix, there's no need to switch to AWS, enabling faster and more comprehensive root cause analysis.
• Resource optimization and inventory management. Centralizing all cloud resource information in one view simplifies inventory management and accelerates cloud resource optimization.

Prerequisites

This integration needs an IAM Role in your AWS account with the necessary permissions and trust relationship to allow Coralogix to access your AWS resources. To create the role:

1. Download the template.yaml. See the from CloudFormation project for possible values of parameters.
2. Run the following command in a terminal with installed AWS CLI and configured credentials or AWS CloudShell, replacing the necessary values.

3. Get the ARN of the role and ExternalId for the integration.

      aws cloudformation deploy --capabilities CAPABILITY_IAM  CAPABILITY_NAMED_IAM --template-file <path to template.yaml> --stack-name <the name of the stack that will be deploy in aws> --parameter-overrides CoralogixRegion=<coralogix account region> RoleName=<name of the role> ExternalIdSecret=<external id secret part> CoralogixCompanyId=<coralogix company id>
   

   4. The command will produce output similar to the following:

   ------------------------------------------------------------------------------------------------------------------------------------------------------------
   |                                                                      DescribeStacks                                                                      |
   +----------------------------------------------------+-----------------------------+-----------------------------------------------------------------------+
   |                     Description                    |          OutputKey          |                              OutputValue                              |
   +----------------------------------------------------+-----------------------------+-----------------------------------------------------------------------+
   |  The ExternalId of the Coralogix AWS Metrics role. |  ExternalId                 |  foo@123456                                                           |
   |  The ARN of the Coralogix AWS Metrics role.        |  CoralogixAwsMetricsRoleArn |  arn:aws:iam::123456:role/my-role                                     |
   +----------------------------------------------------+-----------------------------+-----------------------------------------------------------------------+
   

   Note the ExternalId and CoralogixAwsMetricsRoleArn values for the next step.

Integration deployment

1. From the Coralogix UI, go to Data Flow > Integrations.
2. In the Integrations section, select AWS Infrastructure Explorer.
3. Click Add New to add a new AWS infrastructure explorer integration.
4. Enter configuration parameters according to your application requirements:
   • Integration name - A meaningful name assigned to the integration for easier identification of the integration instance.
   • AWS Role ARN - The role ARN created as described in the Prerequisites section above.
   • ExternalId - The ExternalId created as described in the Prerequisites section above.
   • Select AWS Regions - The regions of the AWS account.
5. Pick at least one of the following options:
   • Scan EC2 Instances
   • Scan EC2 Network Interfaces
6. Click Save to create the integration.
7. Continue with the Infrastructure Explorer configuration