Install Observe Agent on Windows

Install and Start the Observe Agent

Install the observe-agent package via the provided installation powershell script. This script needs to be run in a powershell terminal that you run as administrator. Replace ${OBSERVE_TOKEN} and ${OBSERVE_COLLECTION_ENDPOINT} with the appropriate values and run on each host.

[Net.ServicePointManager]::SecurityProtocol = "Tls, Tls11, Tls12, Ssl3"; Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/observeinc/observe-agent/main/scripts/install.ps1" -outfile .\install.ps1; .\install.ps1 -observe_token "${OBSERVE_TOKEN}" -observe_collection_endpoint "${OBSERVE_COLLECTION_ENDPOINT}"

To validate that the agent is installed correctly, you can run the following commands.

Get-Service ObserveAgent
Set-Location "${Env:Programfiles}\Observe\observe-agent"
./observe-agent status

Configure the Observe Agent

The installation powershell script will automatically start the agent for you. You can find the observe-agent.yaml config file in the ${Env:Programfiles}\Observe\observe-agent directory. For more information on configuring the agent, see Configuration.

# Observe data token
token: "${OBSERVE_TOKEN}"

# Target Observe collection url
observe_url: "${OBSERVE_COLLECTION_ENDPOINT}"

host_monitoring:
  enabled: true
  logs: 
    enabled: true
  metrics:
    enabled: true

# otel_config_overrides:
#   exporters:
#     debug:
#       verbosity: detailed
#       sampling_initial: 5
#       sampling_thereafter: 200
#   service:
#     pipelines:
#       # This will override the existing metrics/host_monitoring pipeline and output to stdout debug instead
#       metrics/host_monitoring:
#         receivers: [hostmetrics/host-monitoring]
#         processors: [memory_limiter]
#         exporters: [debug]

Restart the Observe Agent with the updated configuration

If you made any configuration updates, you can restart the agent and apply the new config with the following command.

Restart-Service ObserveAgent

Configure application instrumentation

Once the Observe Agent is up and running on a Windows host, you can configure your application running on the same Windows host to send telemetry data to the Observe Agent using one of the following addresses:

  • OTLP/HTTP endpoint: http://localhost:4318

  • OTLP/gRPC endpoint: http://localhost:4317

Uninstall the Observe Agent

Stop-Service ObserveAgent
Remove-Item -Recurse "${Env:Programfiles}\Observe"

Upgrade the Observe Agent

To upgrade the Observe Agent, run the installation powershell script again. The script will stop the service before installing the new version of the agent and restarting the service.

[Net.ServicePointManager]::SecurityProtocol = "Tls, Tls11, Tls12, Ssl3"; Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/observeinc/observe-agent/main/scripts/install.ps1" -outfile .\install.ps1; .\install.ps1 -observe_token "${OBSERVE_TOKEN}" -observe_collection_endpoint "${OBSERVE_COLLECTION_ENDPOINT}"