> ## Documentation Index
> Fetch the complete documentation index at: https://docs.odigos.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Sources
> Add or instrument sources in the Odigos VM Agent so the agent can collect their telemetry.
There are two ways to add [sources](../../../overview#key-concepts) to the Odigos VM Agent: use `odictl` or use YAML files.
It is recommended to [add a destination](./add-destinations) before adding a source.
```shell theme={null}
odictl
```
Use `Tab` to focus on the Sources pane or press `o`, then press `Enter` or click `+ Add Source` with your mouse.
Type the name of the Linux process in the search bar at the top, and/or press `Tab` and scroll through the list
of sources. Once your source is highlighted, press `Enter`.
Review and adjust the properties if needed:
A human-readable label for the process or systemd service. You can edit this to make the source easier to identify in the UI.
The exact name of the running process as detected by the VM Agent. This field is auto-populated at discovery time — contact support before changing it.
The process type: either `systemd` for services managed by systemd, `process` for standalone Linux processes, or `docker` for docker containers.
This field is auto-populated at discovery time — contact support before changing it.
Controls whether the VM Agent instruments this source. Check to enable instrumentation, or uncheck to pause it without removing the source.
The programming language of the process as detected by the VM Agent. This field is auto-populated at discovery time — contact support before changing it.
The version of the runtime language as detected by the VM Agent. This field is auto-populated at discovery time — contact support before changing it.
Press `Tab` to navigate to `Apply`, then press `Enter` to save and instrument your service.
Once you select `Apply` the service or process will restart.
Select `OK`.
The service or process will restart automatically to apply instrumentation. After it comes back up, it appears in the `Sources` list with a `Health` status of `Success`.
```shell theme={null}
cd /etc/odigos-vmagent/sources.d
```
Create a YAML file for your source's configuration using the editor of your choice. The example below uses [vi](https://en.wikipedia.org/wiki/Vi).
```shell theme={null}
sudo vi example.yaml
```
Define each service or process you want to instrument using the properties below.
A human-readable label for the process or systemd service. You can edit this to make the source easier to identify in the UI.
Controls whether the VM Agent instruments this source. Set to `true` to enable instrumentation, or to `false` to pause it without removing the source.
The exact name of the running process as detected by the VM Agent.
The process type: either `systemd` for services managed by systemd, `process` for standalone Linux processes, or `docker` for Docker containers.
Optional runtime configuration (e.g., language and version). Auto-populated at discovery time — contact support before changing this field.
For example:
```yaml theme={null}
- name: odigos-demo-frontend
enabled: true
serviceName: odigos-demo-frontend
kind: systemd
config: null
- name: odigos-demo-membership
enabled: true
serviceName: odigos-demo-membership
kind: systemd
config: null
```
You can define multiple sources in a single YAML file, and you can organize sources across multiple YAML files.
```shell theme={null}
:wq!
```
```shell theme={null}
sudo journalctl -u odigos-vmagent | grep 'Successfully attached eBPF probes to process'
```
```
Mar 10 20:14:35 ip-10-0-1-51 odigos-vmagent[4203]: time=2026-03-10T20:14:35.846Z level=INFO source=/go/src/github.com/keyval/odigos-vmagent/pkg/components/controller/instrumentor/ebpf_manager.go:179 msg="Successfully attached eBPF probes to process" pid=7251 service=odigos-demo-frontend
Mar 10 20:21:42 ip-10-0-1-51 odigos-vmagent[4203]: time=2026-03-10T20:21:42.098Z level=INFO source=/go/src/github.com/keyval/odigos-vmagent/pkg/components/controller/instrumentor/ebpf_manager.go:179 msg="Successfully attached eBPF probes to process" pid=8308 service=odigos-demo-membership
```