Skip to content

Install Observability on Windows

The dk-installer.exe program installs DataOps Observability as a Docker Compose application. This is the recommended installation mode, as Docker encapsulates and isolates the application from other software on your machine and does not require you to manage Python dependencies.

Prerequisites

Install the following prerequisites, and verify that their versions are supported.

Software Command to check version
Docker + Docker Compose

Why Docker? Docker lets you try Observability without affecting your local software environment. All the dependencies Observability needs are isolated in its containers, so installation is easy and insulated.
Docker: 26.1, 27.5, 28.5

Compose: 2.38, 2.39, 2.40
docker -v

docker compose version

How to install Observability

  1. Download the latest version of dk-installer.exe.
  2. Run the install option.

    1. From your Downloads folder, double-click the dk-installer.exe file to start the program.
    2. If a Windows protected your PC screen is displayed, click the More info link, and then click Run anyway.
    3. In the Choose a Product menu, type 2 for Observability and press Enter.
    4. In the Observability Menu, type 1 for Install Observability and press Enter.

    The installation downloads the latest Docker images for Observability and deploys a new Docker Compose application. The process may take 5~15 minutes, depending on your machine and network connection.

  3. Verify that you can log in to the UI with the URL and credentials provided in the program output. You can also find this information at any time by selecting the Access Installed App option in the Observability Menu.

How to setup demo data

You can also use the installer program to seed Observability with demo data for the Quick Start tutorial.

  1. Run the demo setup option.

    1. From your Downloads folder, double-click the dk-installer.exe file to start the program.
    2. In the Choose a Product menu, type 2 for Observability and press Enter.
    3. In the Observability Menu, type 4 for Install Observability demo data and press Enter.

    In the Observability UI, you will see that new journeys and events have been generated.

  2. Run the Agent Heartbeat demo setup option.

    1. From your Downloads folder, double-click the dk-installer.exe file to start the program.
    2. In the Choose a Product menu, type 2 for Observability and press Enter.
    3. In the Observability Menu, type 6 for Run heartbeat demo and press Enter.

    In the Observability UI, you will see that new agents have been generated on the Integrations page.

  3. Follow the Observability portions of the Quick Start demo tutorial for a walk-through of the software.

Tip

To upgrade an instance of Observability to the latest released version, see Upgrade Observability. For other post-install tasks, see Administer Observability.


How to remove demo data

After completing the quickstart, you can remove the demo data from Observability with the following steps.

  1. Run the delete demo option.

    1. From your Downloads folder, double-click the dk-installer.exe file to start the program.
    2. In the Choose a Product menu, type 2 for Observability and press Enter.
    3. In the Observability Menu, type 5 for Delete Observability demo data and press Enter.

    Note: Currently, the agents generated by the heartbeat demo are not cleaned up.