Devaten Quick Launch Guide

This guide will help you to setup your On-Prem environment using Docker. Please follow the below steps to setup the complete eco-system on your environment

1. Install On-Prem dashboard

How to Install

To run the On-Premise common Agent Docker Compose File locally, you must have Git,Docker and Docker Compose installed and do the following:

1. Firstly Clone the Docker Compose file from Github using

   git clone

Configure docker-compose.yml:

Once the cloning process is complete, you will see the ‘onpremises-common-agent’ folder. Open the ‘docker-compose.yml’ file in that folder using any text editor, such as Notepad or VS Code.

Here is a step-by-step guide to update the fields in your docker-compose.yml file

1. Locate the openai.apiKey Field:

openai.apiKey: Enter-your-openai-key

  • Replace Enter-your-openai-key with your actual OpenAI API key.

2. Set the openai.apiurl Field:

openai.apiurl: Enter-open-ai-api-url

  • Replace Enter-open-ai-api-url with the appropriate URL

3. Define the openai.responsemodel Field:

openai.responsemodel: Enter-open-ai-responsemodel

  • Replace Enter-open-ai-responsemodel with the model name.
  • Use ‘gpt-3.5-turbo’ or ‘gpt-4’ for the response model.

4. Specify the openai.server Field:

openai.server: Enter-open-ai-server
  • Replace Enter-open-ai-server with the appropriate server name.
  • For Azure, use ‘azure’.
  • For open-source, use ‘openai’.

 5. Adjust the openai.timeintervalinseconds Field:

openai.timeintervalinseconds: 0

  • Field Name: openai.timeintervalinseconds
  • Description: This field specifies the interval, in seconds, between consecutive OpenAI API calls. It ensures that the calls to the OpenAI API are made with a defined pause between them, avoiding potential rate limiting or excessive usage.
  • Current Value: 0
  • Implications: Setting this value to 0 means there is no delay between consecutive OpenAI API calls. This could lead to rapid successive calls, potentially hitting rate limits or causing performance issues.

6. Set the scheduler.fixed-delay Field:

 scheduler.fixed-delay: 15000

  • Field Name: scheduler.fixed-delay
  • Description: This field defines the delay, in milliseconds, between updates to the Devaten live metric page. It controls how often session data, graphs, and other metrics are refreshed on the live metric page.
  • Current Value: 15000
  • Implications: Setting this value to 15000 means the live metric page will update every 15 seconds. This frequent updating ensures that users see near-real-time data and metrics, providing a current view of sessions and graphs.

7. Configure the scheduler.cpu.collertor-type Field:

  • Options include OFF, AGENT, or CLIENT_TABLE.
  • Replace AGENT with your desired collector type.

8. Enter Details for Azure DevOps:

azure.devops.organization: your-organisation
azure.devops.project: your-project
azure.devops.tickettype: task
azure.devops.pat: your-token-for-api-calls

  • Replace Enter-your-organisation with your Azure DevOps organization name.
  • Replace Enter-your-project with your Azure DevOps project name.
  • Replace enter task with your desired ticket type .
  • Replace Enter-your-token-for-api-calls with your Azure DevOps personal access token.

9. Set Up SMTP Configuration:
smtp.password: your-password

  • Replace [HOST_URL] with your SMTP host URL.
  • Replace [EMAILID] with your SMTP email address.
  • Replace [PASSWORD] with your SMTP password.

Once you have updated all the fields with your actual data, your docker-compose.yml file should be ready for use.

How to Run:

2. After the clone is complete, navigate to the ‘On-Premise common agent’ folder, open a terminal, and run the following commands:

   docker-compose pull

This will download the docker images locally.

3.  To run Docker Images mentioned in Docker Compose File, Write the following   command:

    docker-compose up

The above command will starts all the docker containers.

Follow below video to configure and run devaten application.


2. Configure On-Prem application

Go to: http://localhost:8081

Do following configurations 

Connect agent to dashboard / Add Agent


Sign in to Devaten Saas to get license key

Register using same email and password

You will get license key on your registered email.

Application configuration


configure your application.

 Configure databases. 


configure your data sources.

Set alerts.


Configure monitoring queries.


    • Define your Usecase Identifier
    • Start Recording
    • Perform Operations on Database
    • Stop Recording
    • View Reports

Configure Jira


3. Install Middleware

How to Install

Firstly, Clone the Middleware file from GitHub using following command.

    git clone

How to Configure:

Edit middleware.env file

Add into your configure file your IP address where docker is running.

Example; ipconfig

IPv4 Address.:

–> APP_HOST=”″

After the change verify Devaten is running on this same address.

How to Run:

  • To install the middleware locally, you must have docker and docker       compose installed and do the following:
  •  Download the docker compose file from the release.
  •  Open the directory in a terminal where the docker compose file is.
  •   Write the following command:
  docker-compose pull

This will download the docker images locally.

To start program open a terminal and navigate to the folder containing the docker compose file.

Write following command

  docker-compose up

For more details visit

4. Install query comment

Query comment, instrumenting.

  • Configure query commenter

       Follow below link to install query comment.

      GitHub can be found here

        Alternative, Instrument, install query comment

          You can follow README file to install query comment.

5. Integrate your Test Suit with Middleware with easy http calls.

 GitHub can be found here:

         Integrate with your test suite

    You can follow README file to install and integrate middleware with your test suite.

6. Verify results

See results on Grafana, and notifications to Jira.

Established in 2013 as a software consultancy company, Devaten has worked with finance and healthcare businesses to enhance their software development projects. Taking its offerings to the next level, Devaten built a leading use case-based database application monitoring tool, with a unique approach to performance improvement early during software development. Headquartered in Turku, Finland.

Copyright © 2024 Devaten, All rights reserved.