# Build Your First Configuration

{% embed url="<https://www.youtube.com/watch?v=zqeUafSsoXg>" %}

### Configuration

To set up a collector configuration, navigate to the **Configurations** tab and click **Create Configuration**.

<figure><img src="https://1405008107-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmiOMzBfoNFwmKJFHMcJ%2Fuploads%2Fgit-blob-ca29ae84cefdc86a9b76d4fd1d703d5a29483b18%2Fgetting-started-with-bindplane-build-your-first-configuration-image-1.webp?alt=media" alt="Bindplane docs - Build Your First Configuration - image 1"><figcaption></figcaption></figure>

You'll now be in the configuration wizard.

1. Give your config a name (see naming rules below)
2. Choose a platform for it to run on that corresponds to your collector(s)
3. You can optionally add a description for the config, then click **Next**

<figure><img src="https://1405008107-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmiOMzBfoNFwmKJFHMcJ%2Fuploads%2Fgit-blob-d81557b313ca26691d7a853ab70de801035a44c9%2Fgetting-started-with-bindplane-build-your-first-configuration-image-2.webp?alt=media" alt="Bindplane docs - Build Your First Configuration - image 2"><figcaption></figcaption></figure>

{% hint style="info" %}
**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
  {% endhint %}

#### Add a Source

Next, we'll add sources to our configuration. Sources are where you'd like to collect metrics, logs, or traces. We will start by collecting some host metrics using the Host source.

1. Click Add Source
2. Choose "Host"
3. Choose the metrics you'd like to collect
4. Click **Save** when you're all done

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.

<figure><img src="https://1405008107-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmiOMzBfoNFwmKJFHMcJ%2Fuploads%2Fgit-blob-ba83be3dddb195ca28189e5f01803a21c829a213%2Fgetting-started-with-bindplane-build-your-first-configuration-image-3.webp?alt=media" alt="Bindplane docs - Build Your First Configuration - image 3"><figcaption></figcaption></figure>

#### Add a Destination

The last step is to add a destination. This is where you'd like to ship your telemetry for storage or analysis. Bindplane supports the most popular destinations out of the box. [You can find a full list here.](https://docs.bindplane.com/integrations/destinations)

For this example, we will show you how to configure a Google Cloud destination.

1. Click Add Destination
2. Select "Google Cloud" from the list of destinations
3. Enter a name (corresponding with the same naming rules listed above)
4. Fill in your Project ID
5. Select the desired authentication method

{% hint style="info" %}
**NOTE**

📘 If the VM running your Bindplane collector is already in Google Cloud, then you can leave the authentication method as auto.

📘 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](https://cloud.google.com/iam/docs/creating-managing-service-accounts) with the following roles:

* Metrics: roles/monitoring.metricWriter
* Logs: roles/logging.logWriter
* Traces: roles/cloudtrace.agent

[Create a service account JSON key](https://cloud.google.com/iam/docs/creating-managing-service-account-keys) and place it on the system that is running the collector.
{% endhint %}

6. Click **Save** to save the destination
7. Click **Save** again to finish building your configuration

<figure><img src="https://1405008107-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmiOMzBfoNFwmKJFHMcJ%2Fuploads%2Fgit-blob-e9ae3f5d45a28a32d92cb8b04b38e24c15567755%2Fgetting-started-with-bindplane-build-your-first-configuration-image-4.webp?alt=media" alt="Bindplane docs - Build Your First Configuration - image 4"><figcaption></figcaption></figure>

#### Apply Configuration

The next page is the Details page for the config you just created.

1. Click the **Add Agents** button to add a collector
2. Select which collectors you'd like to apply the config to
3. Click **Apply**

<figure><img src="https://1405008107-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmiOMzBfoNFwmKJFHMcJ%2Fuploads%2Fgit-blob-5c6feeb09c0064c3c8fd9d1c88b58b7ed8cd92ea%2Fgetting-started-with-bindplane-build-your-first-configuration-image-5.webp?alt=media" alt="Bindplane docs - Build Your First Configuration - image 5"><figcaption></figcaption></figure>

#### Rollout The Configuration

Now that you've built your configuration and specified the collectors it should be applied to, you need to roll out the configuration. [Rollouts](https://docs.bindplane.com/readme/broken-reference) are how we deploy configuration changes to our collectors.

Click "Start Rollout", and your configuration will be sent to your collector(s)!

<figure><img src="https://1405008107-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmiOMzBfoNFwmKJFHMcJ%2Fuploads%2Fgit-blob-ffb6e4918295684b6267e0e0e4d2121ec241d895%2Fgetting-started-with-bindplane-build-your-first-configuration-image-6.webp?alt=media" alt="Bindplane docs - Build Your First Configuration - image 6"><figcaption></figcaption></figure>

### Next Steps

Congratulations! You've successfully configured Bindplane, and you should now see telemetry flowing into your destination. If you run into any issues during setup, don't hesitate to contact us on [Slack](https://launchpass.com/bindplane); we'd be happy to help.

Next, you should take some time to explore the integrations available in Bindplane on our [Sources](https://docs.bindplane.com/integrations/sources) page and [Destinations](https://docs.bindplane.com/integrations/destinations) page.

Once you've configured your first pipeline, we can begin exploring the real power of Bindplane: routing, transforming, and reducing your telemetry data.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bindplane.com/readme/build-your-first-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.