Quickstart

Applies to1.1.0DifficultyBeginner

Your Collector is connected. This page takes you from there to seeing your first workload and its activity in Oculis.

Before you start

You will need:

• An Oculis Collector showing as connected. If you do not have one yet, see Installation.
• An AI application you can run on that infrastructure.

Instrumentation scope in Collector 1.1.0:

• On Linux, macOS, and Docker, supported Python applications can use the host instrumentation the installer configures.
• On Windows, Collector 1.1.0 provides workload discovery and host telemetry. Application instrumentation is configured separately.

Run your AI application

Run your existing AI application the way you normally would, on the infrastructure where the Collector is installed, and let it do enough real work to be worth looking at.

Where supported host instrumentation applies, there is nothing else to set up: no application-code changes and no manual SDK installation are required.

Find the workload in Oculis

1. Open Collectors → Collector Overview.

2. Confirm your host is listed as active.

3. Check that workloads have been discovered on it.

4. Open AI Agents → Agent Inventory to see the workloads themselves.

Depending on the application, a discovered workload appears as an agent or under AI-capable applications. Either way, the workload is visible to Oculis.

Discovery normally appears shortly after the application starts running rather than instantly. If the page is empty on your first look, give it a moment and refresh.

Confirm activity

Open Investigate → Explore to search the runs reported by your workload. Overview → Home also shows recent activity and summary information.

Discovery and telemetry are not the same thing

Discovery confirms that Oculis can see the workload. Application telemetry shows what the workload is doing, and requires Oculis instrumentation in that workload’s environment.

If nothing appears

What you are seeing	Where to go
The Collector is not connected	Collector troubleshooting
The Collector is connected, but no workload is found	Collector troubleshooting
A containerized workload is discovered, but reports no activity	Containerized AI workloads

Next steps

InstallationConnect Oculis to your infrastructure by adding your first Collector.

Oculis CollectorDeployment for every platform, capabilities and limitations, health checks, and troubleshooting.