{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"2"},"_parentId":{"value":"120918819"},"type":{"value":"flat"}},"macroMetadata":{"macroId":{"value":"4a7c0f57-709b-42c4-a35e-d1ca7cba1005"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"950253b5-f179-4e26-bf18-1aeb31ec3196"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Service description","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"Amazon Web Services","type":"text","marks":[{"type":"link","attrs":{"href":"https://aws.amazon.com"}}]},{"text":" (AWS) provides on-demand cloud computing platforms and APIs to individuals and companies. Each available AWS service generates information related to different aspects of its functionality.","type":"text"},{"text":" The AWS collector will use some of the available AWS APIs for retrieving this information and sending it to the Devo platform. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]}]},{"type":"paragraph","content":[{"text":"You can use the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]},{"text":"AWS collector","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}},{"type":"strong"}]},{"text":" to send this information to your Devo domain. Once the gathered information arrives at Devo, it will be processed and included in different tables in the associated Devo domain.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#091e42"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Data source description","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"From the monitoring point of view, AWS generates the following types of information:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Events","type":"text","marks":[{"type":"link","attrs":{"href":"#events"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Metrics","type":"text","marks":[{"type":"link","attrs":{"href":"#metrics"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Logs","type":"text","marks":[{"type":"link","attrs":{"href":"#logs"}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"events"},"_parentId":{"value":"120918819"}},"macroMetadata":{"macroId":{"value":"67a6e382-34a7-4664-98bd-436c484d945b"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"aca05c30-555c-4c61-aab0-86d59ff4dae0"}},{"text":"Events","type":"text"}]},{"type":"paragraph","content":[{"text":"Information that happens at a specific timestamp. This information will always be joined to that timestamp, and can be categorized into two different subtypes:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Service events","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The different available services usually generate information related to their internal behaviors, such as","type":"text"},{"text":" A virtual machine has been started","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"A new file has been created in an S3 bucket","type":"text","marks":[{"type":"em"}]},{"text":" or ","type":"text"},{"text":"An","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"AWS lambda function has been invoked","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that this type of event can be triggered with no human interaction. These kinds of events are managed by the ","type":"text"},{"text":"CloudWatch Events service","type":"text","marks":[{"type":"strong"}]},{"text":" (CWE).","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Audit events","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"These events are more specific because they need human interaction no matter the different ways used (API, web interaction, or even CLI command). These events are managed by the ","type":"text"},{"text":"CloudTrail service","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"metrics"},"_parentId":{"value":"120918819"}},"macroMetadata":{"macroId":{"value":"edd43d8f-ff2b-42c6-a297-788c9647cece"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"7393fc5e-d582-49e9-8e9c-5e8a7188c427"}},{"text":"Metrics","type":"text"}]},{"type":"paragraph","content":[{"text":"According to the standard definition, this kind of information is usually generated at the same moment it is requested because it is usually a query about the status of a service (all things inside AWS are considered services).","type":"text"}]},{"type":"paragraph","content":[{"text":"AWS makes something slightly different because it generates metrics information every N time slots, such as 1 min, 5 min, 30 min, 1h, etc., even if no one makes a request (it is also possible to have information every X seconds but this would require an extra cost). This kind of information is managed by the ","type":"text"},{"text":"CloudWatch Metrics service","type":"text","marks":[{"type":"strong"}]},{"text":" (CWM).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"logs"},"_parentId":{"value":"120918819"}},"macroMetadata":{"macroId":{"value":"09e90b51-1acc-45cd-87dd-24ecd1d75111"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"d2c2536e-30a9-4064-adcb-4083d9d3d160"}},{"text":"Logs","type":"text"}]},{"type":"paragraph","content":[{"text":"Logs can be defined as information with a non-fixed structure that is sent to one of the available “logging” services. These services are ","type":"text"},{"text":"CloudWatch Logs","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"S3","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"There are some very customizable services, such as AWS Lambda, or even any developed application which is deployed inside an AWS virtual machine (EC2), that can generate custom log information. This kind of information is managed by the CloudWatch Logs service (CWL) and also by the S3 service. There are also some other services that can generate logs with a fixed structure, such as VPC Flow Logs or CloudFront Logs. These kinds of services require one special way of collecting their data.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Some services generate information that can be sent to different targets at the same time, for example, the CloudTrail service generates audit-related information. This information is really an \"audit event\", but it can be treated as a \"simple event\" and being sent to the Cloudwatch Events service. Also, it can be sent as a string “logline” to the Cloudwatch Logs service or sent as a file to a bucket inside the S3 service.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Almost all services that generate Service events usually send them to Cloudwatch Events service (CWE). It could be said that 90% of services use CloudWatch Events.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CloudWatch Events is in the process of changing its name, the new one is Amazon EventBridge.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"Some manual actions are necessary in order to get all the required information/services and allow the Devo collector to gather the information from AWS. The following sections describe how to get the required AWS credentials and how to proceed with the different required setups depending on the gathered information type.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"credentials"},"_parentId":{"value":"120918819"}},"macroMetadata":{"macroId":{"value":"d523ed33-0697-4390-985c-2a779c3651a3"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"d42b0d01-06a7-4823-9191-835ebc9270a0"}},{"text":"Credentials","type":"text"}]},{"type":"paragraph","content":[{"text":"The AWS collector requires a valid AWS Access Key to start working. To create it, please visit the AWS Console and log in with a user account with enough permissions to create/access AWS structures (depending on whether or not the auto-setup functionality will be used). Then, follow these steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"IAM → Users","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find your user and click on it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the ","type":"text"},{"text":"Security credentials","type":"text","marks":[{"type":"strong"}]},{"text":" tab and click ","type":"text"},{"text":"Create access key","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy and save the Access key ID and the Secret access key to use them later in the collector configuration, in the ","type":"text"},{"text":"access_key","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"access_secret","type":"text","marks":[{"type":"code"}]},{"text":" fields.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"service events"},"_parentId":{"value":"120918819"}},"macroMetadata":{"macroId":{"value":"fc448e2a-5e8e-4273-90c3-122674823c1a"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"ae37023d-1500-441b-892a-54cc3e3c434e"}},{"text":"Service events","type":"text"}]},{"type":"paragraph","content":[{"text":"All service events are managed by the AWS CloudWatch service. This service brings together all service events that are generated by most of the AWS services.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The AWS services generate service events per region, so the next instructions should be applied in each region where the collecting of information is required (use the same values for all your configured regions).","type":"text"}]}]},{"type":"paragraph","content":[{"text":"In order to collect these service events, there are some structures that must be created: one FIFO queue in the SQS service and one Rule+Target in the CloudWatch service.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"If the auto-setup functionality is enabled in the configuration and the related credentials have enough permissions to create all the required AWS structures, the following steps are not required.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"For a manual creation of these required structures, follow the next steps (click to expand):","type":"text"}]},{"type":"expand","attrs":{"title":"SQS FIFO queue creation"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Simple Queue Service","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"Create queue","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Details","type":"text","marks":[{"type":"strong"}]},{"text":" section, choose the ","type":"text"},{"text":"FIFO","type":"text","marks":[{"type":"strong"}]},{"text":" queue type and set the ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":" field value you prefer (it must finish with the ","type":"text"},{"text":".fifo","type":"text","marks":[{"type":"em"}]},{"text":" suffix).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Configuration","type":"text","marks":[{"type":"strong"}]},{"text":" section, set the ","type":"text"},{"text":"Message retention period","type":"text","marks":[{"type":"strong"}]},{"text":" field value to ","type":"text"},{"text":"5 Days","type":"text","marks":[{"type":"em"}]},{"text":". Be sure that the ","type":"text"},{"text":"Content-based deduplication","type":"text","marks":[{"type":"strong"}]},{"text":" checkbox is marked and leave the rest of the options with their default values.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Access policy","type":"text","marks":[{"type":"strong"}]},{"text":" section, choose the method ","type":"text"},{"text":"Basic ","type":"text","marks":[{"type":"strong"}]},{"text":"and select the option ","type":"text"},{"text":"Only the queue owner","type":"text","marks":[{"type":"strong"}]},{"text":" to receive and send permissions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally, in the ","type":"text"},{"text":"Tags","type":"text","marks":[{"type":"strong"}]},{"text":" section, you can create a tag with ","type":"text"},{"text":"Key","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"usedBy","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Value","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"devo-collector.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Create queue","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":"CloudWatch Rule + Target creation"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"CloudWatch → Rules","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"Create rule","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Event Source","type":"text","marks":[{"type":"strong"}]},{"text":" section, select ","type":"text"},{"text":"Event Pattern","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Build event pattern to match events by service","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the","type":"text"},{"text":" Service Name","type":"text","marks":[{"type":"strong"}]},{"text":" field, enter the service to be monitored. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Event Type","type":"text","marks":[{"type":"strong"}]},{"text":" field, choose ","type":"text"},{"text":"All Events","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Targets","type":"text","marks":[{"type":"strong"}]},{"text":" section, click ","type":"text"},{"text":"Add target ","type":"text","marks":[{"type":"strong"}]},{"text":"and choose ","type":"text"},{"text":"SQS queue","type":"text","marks":[{"type":"strong"}]},{"text":" as the target type.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Queue","type":"text","marks":[{"type":"strong"}]},{"text":" dropdown, choose the previously created queue.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Message group ID","type":"text","marks":[{"type":"strong"}]},{"text":" field, set the value ","type":"text"},{"text":"devo-collector.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Then, click ","type":"text"},{"text":"Configure details","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Rule definition","type":"text","marks":[{"type":"strong"}]},{"text":" section, set the ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":" you prefer. Be sure that","type":"text"},{"text":" State","type":"text","marks":[{"type":"strong"}]},{"text":" checkbox is marked.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"audit events"},"_parentId":{"value":"120918819"}},"macroMetadata":{"macroId":{"value":"682a1bf8-68ba-44ff-8d48-982e2e5c65bf"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"8375be1e-7d27-451d-a113-c6d48992014e"}},{"text":"Audit events","type":"text"}]},{"type":"paragraph","content":[{"text":"No actions are required in the Cloudtrail service to retrieve this kind of information.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"metrics"},"_parentId":{"value":"120918819"}},"macroMetadata":{"macroId":{"value":"30fc3117-cb0a-4af2-8ef1-a2c64a2dbe8f"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"7783273a-c525-4619-bd52-afb5013cab1d"}},{"text":"Metrics","type":"text"}]},{"type":"paragraph","content":[{"text":"No actions are required in the CloudWatch Metrics service to retrieve this kind of information.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"logs"},"_parentId":{"value":"120918819"}},"macroMetadata":{"macroId":{"value":"4325995c-8fe1-4d07-8936-66e2df8b5b23"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"ac4683af-69e4-4e71-9018-b636b66cca24"}},{"text":"Logs","type":"text"}]},{"type":"paragraph","content":[{"text":"Logs can be collected from different services. Depending on the service type, you may need to apply some settings on AWS:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CloudWatch Logs","type":"text"}]},{"type":"paragraph","content":[{"text":"No actions are required in this service to retrieve this kind of information.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"VPC Flow Logs","type":"text"}]},{"type":"paragraph","content":[{"text":"Before enabling the generation of these logs, you must create one bucket in the S3 service and one FIFO queue in the SQS service. For a manual creation of these required structures, follow these steps (click to expand):","type":"text"}]},{"type":"expand","attrs":{"title":"SQS queue creation"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Simple Queue Service","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"Create queue","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Details","type":"text","marks":[{"type":"strong"}]},{"text":" section, choose the ","type":"text"},{"text":"Standard ","type":"text","marks":[{"type":"strong"}]},{"text":"queue type and set the ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":" field value you prefer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Configuration","type":"text","marks":[{"type":"strong"}]},{"text":" section, set the ","type":"text"},{"text":"Message retention period","type":"text","marks":[{"type":"strong"}]},{"text":" field value to ","type":"text"},{"text":"5 Days ","type":"text","marks":[{"type":"em"}]},{"text":"and leave the rest of the options with their default values.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Access policy","type":"text","marks":[{"type":"strong"}]},{"text":" section, choose the method ","type":"text"},{"text":"Advanced ","type":"text","marks":[{"type":"strong"}]},{"text":"and replace ","type":"text"},{"text":"\"Principal\": {\"AWS\":\"\"} ","type":"text","marks":[{"type":"em"}]},{"text":"by ","type":"text"},{"text":"\"Principal\": \"*\" ","type":"text","marks":[{"type":"em"}]},{"text":"Leave the rest of the JSON as default.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally, in the ","type":"text"},{"text":"Tags","type":"text","marks":[{"type":"strong"}]},{"text":" section, you can create a tag with ","type":"text"},{"text":"Key","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"usedBy","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Value","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"devo-collector.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Create queue","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":" S3 bucket creation/configuration"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"S3","type":"text","marks":[{"type":"strong"}]},{"text":" and click","type":"text"},{"text":" Create bucket","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the preferred value in the ","type":"text"},{"text":"Bucket name","type":"text","marks":[{"type":"strong"}]},{"text":" field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose the required ","type":"text"},{"text":"Region","type":"text","marks":[{"type":"strong"}]},{"text":" value and click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally, in the ","type":"text"},{"text":"Tags","type":"text","marks":[{"type":"strong"}]},{"text":" section, you can create a tag with ","type":"text"},{"text":"Key","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"usedBy","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Value","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"devo-collector. ","type":"text","marks":[{"type":"em"}]},{"text":"Leave the rest of the fields with their default values and click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Create bucket","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mark the checkbox next to the previously created S3 bucket.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the popup box, click ","type":"text"},{"text":"Copy Bucket ARN","type":"text","marks":[{"type":"strong"}]},{"text":" and save the content. You will need it later.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the S3 bucket list, click the previously created bucket name link.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" tab, then click the ","type":"text"},{"text":"Events","type":"text","marks":[{"type":"strong"}]},{"text":" box.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Add notification","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the preferred value in the ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":" field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the ","type":"text"},{"text":"All object create events","type":"text","marks":[{"type":"strong"}]},{"text":" checkbox.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Send to","type":"text","marks":[{"type":"strong"}]},{"text":" field, select ","type":"text"},{"text":"SQS Queue","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the previously created SQS queue in the ","type":"text"},{"text":"SQS","type":"text","marks":[{"type":"strong"}]},{"text":" field.","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":" VPC service"},"content":[{"type":"paragraph","content":[{"text":"Once the required AWS structures are created, go to the VPC service and follow these steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select any available VPC (or create a new one).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the","type":"text"},{"text":" Flow Logs","type":"text","marks":[{"type":"strong"}]},{"text":" tab and click ","type":"text"},{"text":"Create flow log","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose the preferred ","type":"text"},{"text":"Filter","type":"text","marks":[{"type":"strong"}]},{"text":" value and the required ","type":"text"},{"text":"Maximum aggregation interval","type":"text","marks":[{"type":"strong"}]},{"text":" value.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Destination","type":"text","marks":[{"type":"strong"}]},{"text":" field, select","type":"text"},{"text":" Send to an S3 bucket","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"S3 bucket ARN","type":"text","marks":[{"type":"strong"}]},{"text":" field set the ARN of the previously created S3 bucket.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure that the ","type":"text"},{"text":"Format","type":"text","marks":[{"type":"strong"}]},{"text":" field has the value ","type":"text"},{"text":"AWS default format","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally, in the ","type":"text"},{"text":"Tags","type":"text","marks":[{"type":"strong"}]},{"text":" section, you can create a tag with ","type":"text"},{"text":"Key","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"usedBy","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Value","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"devo-collector.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Finally, click ","type":"text"},{"text":"Create","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CloudFront Logs","type":"text"}]},{"type":"paragraph","content":[{"text":"Before enabling the generation of these logs, you must create one bucket in the S3 service and one FIFO queue in the SQS service. For a manual creation of these required structures, follow these steps (click to expand):","type":"text"}]},{"type":"expand","attrs":{"title":" SQS queue creation"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Simple Queue Service","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"Create queue","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Details","type":"text","marks":[{"type":"strong"}]},{"text":" section, choose the ","type":"text"},{"text":"Standard ","type":"text","marks":[{"type":"strong"}]},{"text":"queue type and set the ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":" field value you prefer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Configuration","type":"text","marks":[{"type":"strong"}]},{"text":" section, set the ","type":"text"},{"text":"Message retention period","type":"text","marks":[{"type":"strong"}]},{"text":" field value to ","type":"text"},{"text":"5 Days ","type":"text","marks":[{"type":"em"}]},{"text":"and leave the rest of the options with their default values.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Access policy","type":"text","marks":[{"type":"strong"}]},{"text":" section, choose the method ","type":"text"},{"text":"Advanced ","type":"text","marks":[{"type":"strong"}]},{"text":"and replace ","type":"text"},{"text":"\"Principal\": {\"AWS\":\"\"} ","type":"text","marks":[{"type":"em"}]},{"text":"by ","type":"text"},{"text":"\"Principal\": \"*\" ","type":"text","marks":[{"type":"em"}]},{"text":"Leave the rest of the JSON as default.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally, in the ","type":"text"},{"text":"Tags","type":"text","marks":[{"type":"strong"}]},{"text":" section, you can create a tag with ","type":"text"},{"text":"Key","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"usedBy","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Value","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"devo-collector.","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Create queue","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":"S3 bucket creation/configuration"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"S3","type":"text","marks":[{"type":"strong"}]},{"text":" and click","type":"text"},{"text":" Create bucket","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the preferred value in the ","type":"text"},{"text":"Bucket name","type":"text","marks":[{"type":"strong"}]},{"text":" field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Choose the required ","type":"text"},{"text":"Region","type":"text","marks":[{"type":"strong"}]},{"text":" value and click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optionally, in the ","type":"text"},{"text":"Tags","type":"text","marks":[{"type":"strong"}]},{"text":" section, you can create a tag with ","type":"text"},{"text":"Key","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"usedBy","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Value","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"devo-collector. ","type":"text","marks":[{"type":"em"}]},{"text":"Leave the rest of the fields with their default values and click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Create bucket","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mark the checkbox next to the previously created S3 bucket.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the popup box, click ","type":"text"},{"text":"Copy Bucket ARN","type":"text","marks":[{"type":"strong"}]},{"text":" and save the content. You will need it later.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the S3 bucket list, click the previously created bucket name link.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" tab, then click the ","type":"text"},{"text":"Events","type":"text","marks":[{"type":"strong"}]},{"text":" box.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Add notification","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the preferred value in the ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":" field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the ","type":"text"},{"text":"All object create events","type":"text","marks":[{"type":"strong"}]},{"text":" checkbox.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Send to","type":"text","marks":[{"type":"strong"}]},{"text":" field, select ","type":"text"},{"text":"SQS Queue","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the previously created SQS queue in the ","type":"text"},{"text":"SQS","type":"text","marks":[{"type":"strong"}]},{"text":" field.","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":"CloudFront service"},"content":[{"type":"paragraph","content":[{"text":"Once the required AWS structures are created, go to the CloudFront service and follow these steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"ID","type":"text","marks":[{"type":"strong"}]},{"text":" of the target ","type":"text"},{"text":"Distribution","type":"text","marks":[{"type":"em"}]},{"text":" item and access the ","type":"text"},{"text":"Distributing Settings","type":"text","marks":[{"type":"strong"}]},{"text":" options. Then, click ","type":"text"},{"text":"Edit","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Logging","type":"text","marks":[{"type":"strong"}]},{"text":" field, select ","type":"text"},{"text":"On","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Bucket for Logs","type":"text","marks":[{"type":"strong"}]},{"text":" field, enter the ARN of the previously created S3 bucket.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Finally, click the ","type":"text"},{"text":"Yes, Edit","type":"text","marks":[{"type":"strong"}]},{"text":" button.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Collector service details","type":"text"}]},{"type":"paragraph","content":[{"text":"The following tables show details about the predefined services available to be used in the collector configuration.","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"a9b28bba-1c49-4ff9-9adb-fdd04bd43786"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"Devo collector service name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"Complete service name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"CloudWatch filter used","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"CloudTrail source filter used","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"Metrics namespace used","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"Service events","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"(type: ","type":"text","marks":[{"type":"strong"}]},{"text":"events","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"Audit events","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"(type: ","type":"text","marks":[{"type":"strong"}]},{"text":"audits","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"Metrics","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"(type: ","type":"text","marks":[{"type":"strong"}]},{"text":"metrics","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"Logs","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"(type: ","type":"text","marks":[{"type":"strong"}]},{"text":"logs","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"service-events-all","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"All service events","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"{\"account\":[\"\"]}","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"This service will collect all service events information available in the CloudWatch service, no matter the source defined in the event.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"✓","type":"text","marks":[{"type":"textColor","attrs":{"color":"#008000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"audit-events-all","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"All audit events","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"all_sources","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"This service will collect all audit events information available in the CloudTrail service, no matter the source defined in the event.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"✓","type":"text","marks":[{"type":"textColor","attrs":{"color":"#008000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"metrics-all","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"All metrics","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"all_metrics_namespaces","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"This service will collect all metric information from CloudWatch service. Metrics from all the available metric namespaces will be retrieved.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"✓","type":"text","marks":[{"type":"textColor","attrs":{"color":"#008000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"CloudWatch Logs","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"This service will collect the different “Log Streams” that are part of a “Log Group” from the CloudWatch Logs service. Since it is common to have more than one “Log Group” defined, this will require creating one ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" entry per “Log Group”.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"✓","type":"text","marks":[{"type":"textColor","attrs":{"color":"#008000"}},{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"non-cloudwatch-logs","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"Non-CloudWatch Logs","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"This service will collect data from the following services VPC Flow Logs and CloudFront Logs.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"X","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[68.0]},"content":[{"type":"paragraph","content":[{"text":"✓","type":"text","marks":[{"type":"textColor","attrs":{"color":"#008000"}},{"type":"strong"}]}]}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"service-events-all","type":"text","marks":[{"type":"code"}]},{"text":" collector service, the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" string is automatically replaced with the real value.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The values entered in","type":"text"},{"text":" ","type":"text","marks":[{"type":"code"}]},{"text":" must be unique values.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Collector configuration details","type":"text"}]},{"type":"paragraph","content":[{"text":"Depending on the data type chosen for collecting, the following service definitions could be added to the configuration inside the services section. The following are common properties that all services have:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"regions","type":"text","marks":[{"type":"code"}]},{"text":" (mandatory) - It must be a list with valid target region names to be used when collecting data. One processing thread will be created per region. See more info about the available regions ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"request_period_in_seconds","type":"text","marks":[{"type":"code"}]},{"text":" (optional) - The period in seconds to be used between pulling executions (default value: ","type":"text"},{"text":"60","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"pull_retries","type":"text","marks":[{"type":"code"}]},{"text":" (optional) - Number of retries that will be executed when a pulling error occurs (default value: ","type":"text"},{"text":"3","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"tag","type":"text","marks":[{"type":"code"}]},{"text":" (optional) - Used for sending the data to a table different from the default one (in the configuration examples, they appear as commented lines).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Global predefined services","type":"text"}]},{"type":"paragraph","content":[{"text":"These service definitions can be used for collecting in a global way the different data types available in AWS.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"All service events","type":"text"}]},{"type":"codeBlock","content":[{"text":"service-events-all:\n #tag: my.app.aws_service_events\n regions:\n - \n - \n - ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The default target table is ","type":"text"},{"text":"cloud.aws.cloudwatch.events","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The default existing expected SQS queue name for this service is ","type":"text"},{"text":"devo-events-all-.fifo","type":"text","marks":[{"type":"code"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"All audit events","type":"text"}]},{"type":"codeBlock","content":[{"text":"audit-events-all:\n #tag: my.app.aws_audit_events\n regions:\n - \n - \n - ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The default target table is ","type":"text"},{"text":"cloud.aws.cloudtrail.events","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"All metrics","type":"text"}]},{"type":"codeBlock","content":[{"text":"metrics-all:\n #tag: my.app.aws_metrics\n regions:\n - \n - \n - ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The default target table is ","type":"text"},{"text":"cloud.aws.cloudwatch.metrics","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CloudWatch Logs","type":"text"}]},{"type":"paragraph","content":[{"text":"An entry per ","type":"text"},{"text":"Log Stream","type":"text","marks":[{"type":"em"}]},{"text":" that wanted to be processed must be defined. In this example, two different entries have been created (","type":"text"},{"text":"cwl_1","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"cwl_2","type":"text","marks":[{"type":"code"}]},{"text":") for processing the Log Streams called ","type":"text"},{"text":"/aws/log_stream_a","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"/aws/log_stream_b","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"cwl_1:\n #tag: my.app.aws_cwl\n types:\n -logs\n log_group: /aws/log_stream_a\n regions:\n - \n - \n - \ncwl_2:\n #tag: my.app.aws_cwl\n types:\n -logs\n log_group: /aws/log_stream_b\n regions:\n - \n - \n - ","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"As shown in the examples, the types list must be fixed with the log values.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The default target table is ","type":"text"},{"text":"cloud.aws.cloudwatch.logs","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Non-CloudWatch Logs","type":"text"}]},{"type":"codeBlock","content":[{"text":"non-cloudwatch-logs:\n #tag: my.app.aws_cwl\n #vpcflowlogs_sqs_queue_name: \n #cloudfront_sqs_queue_name: \n regions:\n - \n - \n - ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The default target tables are ","type":"text"},{"text":"cloud.aws.vpc.flowlogs","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"cloud.aws.cloudfront.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The default existing expected SQS queue names for this service are ","type":"text"},{"text":"devo-ncwl-vpcfl-","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"devo-ncwl-cfl-","type":"text","marks":[{"type":"code"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The properties ","type":"text"},{"text":"vpcflowlogs_sqs_queue_name","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"cloudfrontlogs_sqs_queue_name","type":"text","marks":[{"type":"code"}]},{"text":" can be used for using custom queue names instead of the default expected ones","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Run the collector","type":"text"}]},{"type":"paragraph","content":[{"text":"Once the data source is configured, you can send us the required information and we will host and manage the collector for you (","type":"text"},{"text":"Cloud collector","type":"text","marks":[{"type":"underline"}]},{"text":"), or you can host the collector in your own machine using a Docker image (","type":"text"},{"text":"On-premise collector","type":"text","marks":[{"type":"underline"}]},{"text":").","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"rw-ui-tabs-macro","parameters":{"macroParams":{"_parentId":{"value":"120918819"}},"macroMetadata":{"macroId":{"value":"e642db22-bbf9-4e51-a337-70a2907cc69f"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://d1bgdtsfe1sjdg.cloudfront.net/refinedtheme-for-cloud/macro-icons/tabs.png"}}],"title":"UI Tabs"}},"localId":"0376a0b1-8a47-4f9a-95d0-c27e4789d5c0"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"rw-tab","parameters":{"macroParams":{"_parentId":{"value":"120918819"},"title":{"value":"Cloud collector"}},"macroMetadata":{"macroId":{"value":"f4ee7a601c80e277e000da7313586b90"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://d1bgdtsfe1sjdg.cloudfront.net/refinedtheme-for-cloud/macro-icons/tab.png"}}],"title":"UI Tab"}},"localId":"9cf3e9a1-712d-4d6d-a462-460f31587e3e"}},{"type":"paragraph","content":[{"text":"We use a piece of software called Collector Server to host and manage all our available collectors. If you want us to host this collector for you, ","type":"text"},{"text":"get in touch with us","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:support@devo.com"}}]},{"text":" and we will guide you through the configuration.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"rw-tab","parameters":{"macroParams":{"_parentId":{"value":"120918819"},"title":{"value":"On-premise collector"}},"macroMetadata":{"macroId":{"value":"e6a713f1efe39ae3d92aa5b0f07cbb68"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://d1bgdtsfe1sjdg.cloudfront.net/refinedtheme-for-cloud/macro-icons/tab.png"}}],"title":"UI Tab"}},"localId":"0689b65e-695d-4f54-b844-0f8b7d268cee"}},{"type":"paragraph","content":[{"text":"This data collector can be run in any machine that has the Docker service available because it should be executed as a docker container. The following sections explain how to prepare all the required setup for having the data collector running.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"The following directory structure should be created for being used when running the AWS","type":"text"},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"collector:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n└── devo-collectors/\n └── aws/\n ├── certs/\n │ ├── chain.crt\n │ ├── .key\n │ └── .crt\n └── config/ \n └── config-aws.yaml","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Devo credentials","type":"text"}]},{"type":"paragraph","content":[{"text":"In Devo, go to ","type":"text"},{"text":"Administration → Credentials → X.509 Certificates","type":"text","marks":[{"type":"strong"}]},{"text":", download the ","type":"text"},{"text":"Certificate","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"Private key","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Chain CA","type":"text","marks":[{"type":"strong"}]},{"text":" and save them in ","type":"text"},{"text":"/devo-collectors/aws/certs","type":"text","marks":[{"type":"code"}]},{"text":". Learn more about security credentials in Devo ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/NDT5/pages/57479321"}}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1822,"id":"aaf3ca1c-adc2-48d9-aed0-92894c6a76f9","collection":"contentId-120918819","type":"file","height":471}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Editing the config-aws.yaml file","type":"text"}]},{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"config-aws.yaml","type":"text","marks":[{"type":"strong"}]},{"text":" file, replace the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" values and enter the ones that you got in the previous steps. In the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":" ","type":"text","marks":[{"type":"code"}]},{"text":"placeholders, enter the value that you choose.","type":"text"}]},{"type":"codeBlock","content":[{"text":"globals:\n debug: false\n id: not_used\n name: aws\n persistence:\n type: filesystem\n config:\n directory_name: state\noutputs:\n devo_1:\n type: devo_platform\n config:\n address: collector-eu.devo.io\n port: 443\n type: SSL\n chain: chain.crt\n cert: .crt\n key: .key\ninputs:\n aws:\n id: \n enabled: true\n requests_per_second: 5\n autoconfig:\n enabled: true\n refresh_interval_in_seconds: 600\n credentials:\n access_key: \n access_secret: \n services:\n service-events-all:\n #tag: my.app.aws_service_events\n #sqs_queue_name: .fifo\n regions:\n - \n - \n - \n audit-events-all:\n #tag: my.app.aws_audit_events\n regions:\n - \n - \n - \n metrics-all:\n #tag: my.app.aws_metrics\n regions:\n - \n - \n - \n non-cloudwatch-logs:\n #tag: my.app.aws_non_cwl\n #cloudfrontlogs_sqs_queue_name: \n #vpcflowlogs_sqs_queue_name: \n regions:\n - \n - \n - \n cwl_1:\n #tag: my.app.aws_cwl\n types:\n - logs\n log_group: \n regions:\n - \n - \n - \n cwl_2:\n #tag: my.app.aws_cwl\n types:\n - logs\n log_group: \n regions:\n - \n - \n - ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"By default, there are several SQS queue name patterns that the collector will try to use for retrieving information from AWS. Depending on the info type, the following patterns exist:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Service events: ","type":"text"},{"text":"devo--.fifo","type":"text","marks":[{"type":"code"}]},{"text":". The property ","type":"text"},{"text":"sqs_queue_name","type":"text","marks":[{"type":"code"}]},{"text":" can be used to choose a custom name.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VPC Flow Logs: ","type":"text"},{"text":"devo-ncwl-vpcfl-","type":"text","marks":[{"type":"code"}]},{"text":". The property ","type":"text"},{"text":"vpcflowlogs_sqs_queue_name","type":"text","marks":[{"type":"code"}]},{"text":" can be used to choose a custom name.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CloudFront: ","type":"text"},{"text":"devo-ncwl-cfl-","type":"text","marks":[{"type":"code"}]},{"text":". The property ","type":"text"},{"text":"cloudfrontlogs_sqs_queue_name","type":"text","marks":[{"type":"code"}]},{"text":" can be used to choose a custom name.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Download the Docker image","type":"text"}]},{"type":"paragraph","content":[{"text":"The collector should be deployed as a Docker container. Download the Docker image of the collector as a .tgz file by clicking the link in the following table:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"d1e5156b-2899-4050-9157-43eea2cd1811"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[883.0]},"content":[{"type":"paragraph","content":[{"text":"Collector Docker image","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[883.0]},"content":[{"type":"paragraph","content":[{"text":"SHA-256 hash","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[883.0]},"content":[{"type":"paragraph","content":[{"text":"collector-aws-docker-image-1.3.0.tgz","type":"text","marks":[{"type":"link","attrs":{"href":"https://drive.google.com/file/d/1SkzXyrNOoXoeMVNyazSd95diY3ksz7r5/view?usp=sharing"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[883.0]},"content":[{"type":"paragraph","content":[{"text":"18e1e45fdfe0f21f10a5324576d7e121a71b45c9665cecf60bd1863439790068","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Use the following command to add the Docker image to the system:","type":"text"}]},{"type":"codeBlock","content":[{"text":"gunzip -c collector-aws-docker-image-.tgz | docker load","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Once the Docker image is imported, it will show the real name of the Docker image (including version info). Replace \"","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":"\" with a proper value.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The Docker image can be deployed on the following services:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Docker","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Docker Compose","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Docker","type":"text"}]},{"type":"paragraph","content":[{"text":"Execute the following command on the root directory ","type":"text"},{"text":"/devo-collectors/aws/","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"docker run \\\n--name collector-aws \\\n--volume $PWD/certs:/devo-collector/certs \\\n--volume $PWD/config:/devo-collector/config \\\n--volume $PWD/state:/devo-collector/state \\\n--env CONFIG_FILE=config-aws.yaml \\\n--rm -it docker.devo.internal/collector/aws:","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" with a proper value.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Docker Compose","type":"text"}]},{"type":"paragraph","content":[{"text":"The following Docker Compose file can be used to execute the Docker container. It must be created in the ","type":"text"},{"text":"/devo-collectors/aws/","type":"text","marks":[{"type":"code"}]},{"text":" directory.","type":"text"}]},{"type":"codeBlock","content":[{"text":"version: '3'\nservices:\n collector-aws:\n build:\n context: .\n dockerfile: Dockerfile\n image: docker.devo.internal/collector/aws:${IMAGE_VERSION:-latest}\n container_name: collector-aws\n volumes:\n - ./certs:/devo-collector/certs\n - ./config:/devo-collector/config\n - ./state:/devo-collector/state\n environment:\n - CONFIG_FILE=${CONFIG_FILE:-config-aws.yaml}","type":"text"}]}]},{"type":"paragraph"}],"version":1}

Browser not supported