---

Fiberplane is a collaborative notebook that connects to your observability stack and helps you monitor and debug your infrastructure. Fiberplane is currently available for the Web in closed beta - you can sign up for early access 👉 here.

You can explore a Fiberplane Notebook by simply going to fp.new in the address bar of your browser, however, in order to save your notebook or query your observability data you will need to create an account and establish access to your infrastructure.

Fiberplane accesses your infrastructure through Proxy, a lightweight package, available as a Docker image, that once installed allows you to query your observability data from your Notebook.

Whenever you execute a query in the notebook:

1. The query is forwarded to the Fiberplane Proxy in your cluster;
2. The Proxy then queries the data source (e.g. your Prometheus or Elastic instance);
3. The Proxy processes, encrypts, and then returns the data back to the Studio.

*Note:* Fiberplane Proxy is currently optimized to work with Kubernetes and Prometheus. Elasticsearch, Loki and more providers are coming soon.

This guide will walk you through how to set up the Fiberplane Proxy and install it in your Kubernetes cluster or run it locally for testing purposes.

To work with Fiberplane Templates and setup Providers you will need to install the Fiberplane CLI. You can download and install fp with one command:

Either Homebrew:

brew install fiberplane/tap/fp

or install script:

curl --proto '=https' --tlsv1.2 -sSf https://fp.dev/install.sh | sh

curl -O https://fp.dev/fp/latest/aarch64-apple-darwin/fp
chmod 755 ./fp

curl -O https://fp.dev/fp/latest/x86_64-apple-darwin/fp
chmod 755 ./fp

curl -O https://fp.dev/fp/latest/x86_64-unknown-linux-gnu/fp
chmod 755 ./fp

You will need to authenticate the downloaded CLI with your Fiberplane account so you can create and register the Proxies. Simply type:

fp login

You will be then prompted to login with your account. When you complete the login you can safely close the window.

In order for fpd to receive queries from Fiberplane Notebooks, it needs to be authorized. This step will generate a Daemon API Token that will be needed in later steps.

To register an fpd run a command fp daemon create:

$ fp daemon create
Added proxy "robust-antelope" # generates a random name
Proxy API Token: XXX_XX # and a token - save this for later!

1. Make sure you have Docker installed.
2. Create a data_sources.yaml in the current directory in the following format:

# data_sources.yaml
#
# Replace the following line with the name of the data source
- name: prometheus-prod
  description: Prometheus (Production)
  providerType: prometheus
  config:
    # Replace the following line with your Prometheus URL
    url: http:https://prometheus

3. Run the following command replacing <FPD_API_TOKEN> with the fpd API Token created earlier:

docker run \
  -v "$PWD/data_sources.yaml:/app/data_sources.yaml" \
  fiberplane/fpd:v2 \
  --token=<FPD_API_TOKEN>

We're always looking to improve our onboarding experience! Please report any issues and share your feedback by either:

• emailing us at [email protected].
• submitting an issue here on Github.