Containerized Installation

It is possible to run the VividCortex agent in a virtualization environment. Given the nature of containerized resources, the agent can only monitor using the off-host monitoring method. We have provided buildpacks that will set up agents for Docker and Heroku.

For Docker, you can find instructions and the necessary files here.

For Heroku, you can find instructions in the readme of the buildpack repo, located here. To uninstall VividCortex Buildpack from Heroku see Removing Heroku buildpack.

Generic Container Installation

If for whatever reason you cannot use the files listed above, or if you are using a different container, you will still be able to download and run the VividCortex software by setting the following environment variables in your container:

Variable Name Description
VC_API_TOKEN The VividCortex API token for your environment. You can find this by clicking the “Add New Host” wizard in the VividCortex web application and select “Containerized.”
VC_DRV_MANUAL_HOST_URI URI of the database you wish to monitor. The acceptable syntax is below this table.
VC_HOSTNAME The name of this container host. This is optional, but providing a human-readable name is highly recommended.
VC_DRV_MANUAL_QUERY_CAPTURE Set to poll if you are monitoring a host outside of the container, such as at Amazon RDS. Set to sniff if your database server will be installed inside the container and you want to monitor traffic via TCP sniffing.

VC_DRV_MANUAL_HOST_URI is a comma-separated list of database URIs. The formats are as follows:

Database URI syntax
MongoDB mongo://user:pass@
MySQL mysql://user:pass@
PostgreSQL postgres://user:pass@
Redis redis://:pass@

Please contact Support by emailing or by using the in-app chat if you have any questions.