All docs

Quick start

One Linux host and one agent is enough to see a complete dataset. This page does one thing: get Diting running in your environment as fast as possible.

Before you start

  • Linux host, kernel 3.10 or later
  • root access (the agent installer needs it)
  • network path to the platform
  • SELinux disabled, or the Diting policy module loaded

Deploy the platform first. Standalone, performance and HA profiles are covered in Deploy and offline install.

Install the agent

Copy the agent package to the host, unpack it and run:

sudo ./install.sh

The installer checks the kernel, mounts debugfs and tracefs, writes the systemd unit and starts the agent. Confirm the service:

systemctl status diting-agent

Verify

Ask the agent what it can do:

diting-agent probe

Then read the kernel capability report:

curl -s localhost:<agent-port>/kernel-capabilities | jq

Every capability is listed with a verdict. Anything unavailable comes with a reason; nothing fails silently.

Finally open the console and find the host. If host metrics, network traffic and services appear, the path is working.

First data to check

  1. Hosts: agent online, capture lanes healthy
  2. Traces: open a recent request, confirm spans are complete
  3. Logs: search for a keyword and confirm entries arrive
  4. Databases: if there is database traffic, check QAN for statements

Common issues

  • Agent offline: check systemctl status, then /var/log/diting/agent.log
  • Host online but no traces: confirm capture mode, interfaces and east-west traffic
  • Capability unavailable: read the reason in /kernel-capabilities; usually permissions or kernel config

More in Troubleshooting.

Related: Deploy and offline install, Host onboarding and kernels, Troubleshooting.