This guide will walk you through installing BindPlane on Linux, adding an Agent, and configuring a Destination.
An installation script is available to simplify installation. To see further installation options, check out our Installation page.
curl -s https://storage.googleapis.com/observiq-cloud/bindplane/latest/install-linux.sh | bash -s --
First step is to initialize the server. For Linux, the default command for this is:
sudo /usr/local/bin/bindplane init server --config /etc/bindplane/config.yaml
bindplane initcommand from the installer
The Server Initialization section of the installer will have the exact
bindplane initcommand for your system.
This does the following to parameters in the
config.yaml located by default at
hostto the instance's IP address, or 0.0.0.0 to bind to all IP addresses.
usernameto your desired username
passwordto your desired password
serverURLto the HTTP endpoint of the server.
remoteURLto the web socket endpoint of the server
secretKeyto a new randomly generated UUID. This is automatically generated by the
Use the following command to restart the BindPlane server.
sudo systemctl restart bindplane
Web server access logs can be viewed with:
sudo journalctl -f --unit bindplane
All other BindPlane logs are written to
/var/log/bindplane/bindplane.log. This log file is rotated and compressed by the BindPlane process.
The BindPlane CLI can be used from the BindPlane Server. For an example command, run:
sudo bindplane --config /etc/bindplane/config.yaml help
For a detailed list of commands and a guide to installing the CLI on remote clients, see our CLI page.
The BindPlane UI can be accessed with your browser on port 3001. The URL will be
http://<IP Address>:3001 with IP Address being the IP of the BindPlane server. To log in, use the credentials you specified when running the
In the UI, you'll find the Agents, Configs, and Components tabs. Next, you'll setup an agent.
Click the Install Agents button. Choose the operating system for the intended agent host, and copy the command generated. Run this command on your agent host system.
BindPlane installs the observIQ OpenTelemetry Collector, to learn more checkout the GitHub page.
Upon successfully installing the agent, it will appear back on the Agents tab with a "Connected" status.
To setup a configuration for the agent, navigate to the Configs tab and click New Configuration.
You'll now be in the configuration wizard. First is to name your config (see naming rules below). Then choose a platform for it to run on that corresponds to your agent(s). You can optionally add a description for the config, then click Next.
Note: Rules for naming configs.
- must be 63 characters or less
- must begin and end with an alphanumeric character ( [a-z0-9A-Z] )
- can contain dashes ( - ), underscores ( _ ), dots ( . ), and alphanumerics between
You can use existing OpenTelemetry config.yaml files.
If you already have an OpenTelemetry
config.yaml, you can click the link to the raw configuration wizard. Add a name, choose a platform, and optionally add a description, then click Next. You can then either upload or copy and paste your
Now you can add sources to your config. For this example, we'll just be using the Host source to collect host metrics. Add the source and set the parameters.
For the Host source, there are many metrics enabled by default and optional metrics that can also be enabled.
Click Save when you're done with the source configuration. You can add more sources, click on existing ones to see their configuration and edit or remove them, or click Next to move on to adding a destination.
Last step is to add a destination. In this example, we'll use Google Cloud. Select the destination and configure the required settings.
For Google Cloud, enter a name (corresponding with the same naming rules listed above), fill in your project ID, then select the authentication method. If the VM running your BindPlane agent is already in Google Cloud, then you can leave the authentication method to auto. Otherwise, copy the contents of a credential json and paste it into the configuration wizard, or create a credentials file and place it on the host system, then fill in the file path in the configuration wizard.
When you're finished with the destination configuration, click Save. You can click on the destination to see the configuration and edit or remove it, or click Save to move on to finish the configuration.
Creating a credentials file for Google Cloud
A Google Cloud Service Account can used for authentication by creating a service account and key.
Create a service account with the following roles:
- Metrics: roles/monitoring.metricWriter
- Logs: roles/logging.logWriter
- Traces: roles/cloudtrace.agent
Create a service account json key and place it on the system that is running the collector.
The next page is the Details page for the config you just created. At the bottom of the page in the Agents section, click the + icon to add an agent. Select which agents you'd like to apply the config to, then click Apply. Just like that, the config is now running on the agent!
Updated 5 days ago