{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"style":{"value":"none"},"type":{"value":"flat"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"5aa5e047-028e-4bb5-8bb4-fc70e0d564a4"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"c08f7e97-4e69-4e1e-a585-24cd6ada23cc"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Running the Generic Collector","type":"text"}]},{"type":"paragraph","content":[{"text":"The generic collector can be run using any of the following methods:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cloud Collector → this method runs the collector as a service (Cloud Collector App).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Docker container → this method runs the collector in standalone mode (on-premise).","type":"text"}]}]}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"rw-ui-tabs-macro","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"1c9290d8-0a22-40ac-9158-33d12fada37b"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://static.dg.refinedtheme.refinedwiki.com/refinedtheme-for-cloud/macro-icons/tab-container.png"}}],"title":"Refined Tab Container"}},"localId":"25f6dab1-5195-4981-bd1f-8de79f23e3f4"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"rw-tab","parameters":{"macroParams":{"title":{"value":"Cloud collector"}},"macroMetadata":{"macroId":{"value":"e3b8acbca52afecc3448ddca7eb0ed24843fb6139f310c2c3ef04caf9d0c1300"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://static.dg.refinedtheme.refinedwiki.com/refinedtheme-for-cloud/macro-icons/tab.png"}}],"title":"Refined Tab"}},"localId":"9ee592a6-1723-45c0-8168-2a17c49a6d78"}},{"type":"paragraph","content":[{"text":"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:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access the ","type":"text"},{"text":"Cloud Collector App","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the ","type":"text"},{"text":"Catalog","type":"text","marks":[{"type":"strong"}]},{"text":" to see the list of all the available integrations for your Devo domain.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on ","type":"text"},{"text":"Create instance","type":"text","marks":[{"type":"strong"}]},{"text":" for the integration you want to instantiate and fill in the details.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Collector Name","type":"text","marks":[{"type":"strong"}]},{"text":": set the desired value (it must be unique within the current Devo domain).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Version","type":"text","marks":[{"type":"strong"}]},{"text":": select the latest value available.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Collector parameters (JSON)","type":"text","marks":[{"type":"strong"}]},{"text":": copy-paste the config template of the corresponding integration.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ","type":"text"},{"text":"Create Instance","type":"text","marks":[{"type":"strong"}]},{"text":" button at the bottom right when you finish.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelIconId":"atlassian-note","panelIcon":":note:","panelColor":"#EAE6FF","panelType":"custom"},"content":[{"type":"paragraph","content":[{"text":"Find the JSON config file for your integration here","type":"text","marks":[{"type":"link","attrs":{"href":"https://devodocs.atlassian.net/wiki/spaces/LAD/pages/943095809/Generic+collector#List-of-integrations"}}]},{"text":".","type":"text"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"rw-tab","parameters":{"macroParams":{"title":{"value":"On-premise"}},"macroMetadata":{"macroId":{"value":"b29c371d9ad7239946ad26d464ef7dbe9dab73c7339e5b64e2b61ac27d981471"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://static.dg.refinedtheme.refinedwiki.com/refinedtheme-for-cloud/macro-icons/tab.png"}}],"title":"Refined Tab"}},"localId":"93ba288d-83ed-4ebf-8e2d-01f7fdfc4448"}},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Collector directory structure","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n└── devo-collectors/\n └── devo--collector-/\n ├── certs/\n │ ├── chain.crt\n │ ├── .key\n │ └── .crt\n └── config/\n └── config-generic.yaml","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The reason for having ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" placeholders is to make it possible to have several integrations and several instances of integrations inside the ","type":"text"},{"text":"devo-collectors","type":"text","marks":[{"type":"code"}]},{"text":" directory.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Getting Devo certificates","type":"text"}]},{"type":"paragraph","content":[{"text":"To send data securely to the Devo platform, you will need to download ","type":"text"},{"text":"X.509 Certificates","type":"text","marks":[{"type":"strong"}]},{"text":" from your Devo Domain. Download \"","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","type":"text","marks":[{"type":"strong"}]},{"text":"\" and save it on ","type":"text"},{"text":"/devo-collectors/devo--collector-/certs/","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":736,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":950,"alt":"image-20241106-143015.png","id":"d455b41f-bb34-44f8-8288-1defa1cc424a","collection":"contentId-943095809","type":"file","height":448}}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"For more information about how to get the Devo certificates, please visit ","type":"text"},{"text":"Devo Docs","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.devo.com/confluence/ndt/domain-administration/security-credentials#Securitycredentials-X.509_certificatesX.509Certificates"}}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Editing config-generic.yaml file","type":"text"}]},{"type":"paragraph","content":[{"text":"Copy-paste the config template of the corresponding integration.","type":"text"}]},{"type":"panel","attrs":{"panelIconId":"atlassian-note","panelIcon":":note:","panelColor":"#EAE6FF","panelType":"custom"},"content":[{"type":"paragraph","content":[{"text":"Find the YAML config file for your integration here","type":"text","marks":[{"type":"link","attrs":{"href":"https://devodocs.atlassian.net/wiki/spaces/LAD/pages/943095809/Generic+collector#List-of-integrations"}}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Downloading the Docker image","type":"text"}]},{"type":"paragraph","content":[{"text":"The collector should be deployed as a Docker container. Download the Docker image from the corresponding integration as a ","type":"text"},{"text":".tgz","type":"text","marks":[{"type":"code"}]},{"text":" file:","type":"text"}]},{"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-generic-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 the corresponding value. Once the Docker image is imported, it will show the real name of the Docker image (including version info).","type":"text"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"9c547eea-b876-4871-ae39-65b470ba418e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest,#f0f0f0)","rowspan":1,"colwidth":[323.0]},"content":[{"type":"paragraph","content":[{"text":"Collector Docker image","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"var(--ds-background-accent-gray-subtlest,#f0f0f0)","rowspan":1,"colwidth":[323.0]},"content":[{"type":"paragraph","content":[{"text":"SHA-256 hash","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":2,"rowspan":1,"colwidth":[323.0,323.0]},"content":[{"type":"panel","attrs":{"panelIconId":"atlassian-note","panelIcon":":note:","panelColor":"#EAE6FF","panelType":"custom"},"content":[{"type":"paragraph","content":[{"text":"Find the DOCKER IMAGE and SHA-256 HASH for your integration here","type":"text","marks":[{"type":"link","attrs":{"href":"https://devodocs.atlassian.net/wiki/spaces/LAD/pages/943095809/Generic+collector#List-of-integrations"}}]},{"text":".","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Deploying the collector","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Using Docker (option 1)","type":"text"}]},{"type":"paragraph","content":[{"text":"Execute the following command on the root directory ","type":"text"},{"text":"/devo-collectors/devo--collector-/","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"docker run \\\n--name devo--collector- \\\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-generic.yaml \\\n--rm -it devo.com/collectors/generic-collector:","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" with the corresponding value.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Using Docker-Compose (option 2)","type":"text"}]},{"type":"paragraph","content":[{"text":"The content of the ","type":"text"},{"text":"docker-compose-yaml","type":"text","marks":[{"type":"code"}]},{"text":" file below can be used to execute the Docker container, and it should be created inside the ","type":"text"},{"text":"/devo-collectors/devo--collector-/","type":"text","marks":[{"type":"code"}]},{"text":" directory:","type":"text"}]},{"type":"codeBlock","content":[{"text":"version: '3'\nservices:\n devo-generic-collector:\n build:\n context: .\n dockerfile: Dockerfile\n image: devo.com/collectors/generic_collector:${IMAGE_VERSION:-latest}\n container_name: -collector-\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-generic.yaml}","type":"text"}]},{"type":"paragraph","content":[{"text":"To run the container using docker-compose execute the following command from the ","type":"text"},{"text":"/devo-collectors/devo--collector-/ ","type":"text","marks":[{"type":"code"}]},{"text":"directory:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$ IMAGE_VERSION= docker-compose up -d","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Replace ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" with the corresponding value.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"List of integrations","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the list of available integrations for the cloud collector. Click the desired one to see the specific config files that you need to use to configure it.","type":"text"}]},{"type":"expand","attrs":{"title":"Available collectors"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"children","parameters":{"macroParams":{"depth":{"value":"1"},"allChildren":{"value":"true"},"style":{"value":""},"sortAndReverse":{"value":""},"first":{"value":"0"}},"macroMetadata":{"macroId":{"value":"08547e96-82eb-4cf2-b14b-914e931ca236"},"schemaVersion":{"value":"2"},"title":"Child pages (Children Display)"}},"localId":"c8c932a5-f743-4044-b9b3-18308279c92e"}}]}],"version":1}

Browser not supported