Page Comparison

The Cloud Collector is an application that allows you to run sets of collectors grouped by Devo domain destinations. To have an instance of this data collector running, follow these steps:

1. Access the Cloud Collector App.

2. Go to the Catalog to see the list of all the available integrations for your Devo domain.

3. Click on Create instance for the integration you want to instantiate and fill in the details.

   1. Collector Name: set the desired value (it must be unique within the current Devo domain).

   2. Version: select the latest value available.

   3. Collector parameters (JSON): copy-paste the config template of the corresponding integration.

4. Click on the Create Instance button at the bottom right when you finish.

This data collector can be run on any machine with the Docker service available because it should be executed as a Docker container. The following sections explain how to prepare the required setup.

Collector directory structure

<any_directory>
└── devo-collectors/
    └── devo-<integration>-collector-<number>/
          ├── certs/
          │   ├── chain.crt
          │   ├── <your_domain>.key
          │   └── <your_domain>.crt
          └── config/
              └── config-generic.yaml

Getting Devo certificates

To send data securely to the Devo platform, you will need to download X.509 Certificates from your Devo Domain. Download "Certificate", "Private Key" and "Chain" and save it on <any_directory>/devo-collectors/devo-<integration>-collector-<number>/certs/:

Editing config-generic.yaml file

Copy-paste the config template of the corresponding integration.

Downloading the Docker image

The collector should be deployed as a Docker container. Download the Docker image from the corresponding integration as a .tgz file:

Use the following command to add the Docker image to the system:

gunzip -c collector-generic-docker-image-<version>.tgz | docker load

Deploying the collector

Using Docker (option 1)

Execute the following command on the root directory <any_directory>/devo-collectors/devo-<integration>-collector-<number>/

docker run \
--name devo-<integration>-collector-<number> \
--volume $PWD/certs:/devo-collector/certs \
--volume $PWD/config:/devo-collector/config \
--volume $PWD/state:/devo-collector/state \
--env CONFIG_FILE=config-generic.yaml \
--rm -it devo.com/collectors/generic-collector:<version>

Using Docker-Compose (option 2)

The content of the docker-compose-yaml file below can be used to execute the Docker container, and it should be created inside the <any_directory>/devo-collectors/devo-<integration>-collector-<number>/ directory:

version: '3'
services:
  devo-generic-collector:
    build:
      context: .
      dockerfile: Dockerfile
    image: devo.com/collectors/generic_collector:${IMAGE_VERSION:-latest}
    container_name: <integration>-collector-<number>
    volumes:
      - ./certs:/devo-collector/certs
      - ./config:/devo-collector/config
      - ./state:/devo-collector/state
    environment:
      - CONFIG_FILE=${CONFIG_FILE:-config-generic.yaml}

To run the container using docker-compose execute the following command from the <any_directory>/devo-collectors/devo-<integration>-collector-<number>/ directory:

$ IMAGE_VERSION=<version> docker-compose up -d