Organizations¶

Tinybird Organizations provide enterprise customers with a single pane of glass to monitor usage across multiple Workspaces.

The Organizations page in the Tinybird UI includes dashboards for monitoring your consumption of storage and processed data, your Workspaces, and your Organization members. Consumption data is also available via a HTTP API.

Organizations is currently in beta with limited functionality. If you are an administrator of an organization and are interested in using this feature, please contact support@tinybird.co to request access.

Accessing the Organizations UI¶

You must be an Organization admin to access the Organizations UI.

To access the Organizations UI, click on your Workspace name in the top left of the Tinybird UI (see Mark 1 below). Then, scroll down if needed, and click the Manage your organization button at the bottom (see Mark 2 below).

../_images/monitoring-organizations-access-ui-1.png

The Organizations page will open onto the Consumption tab by default.

../_images/monitoring-organizations-access-ui-2.png

Monitoring consumption¶

On this page you will find details about your billing plan, and your usage of the platform.

The Consumption tab is the default page when opening the Organizations UI. You can navigate back to the page by clicking the Consumption tab at the top of the left side nav bar (see Mark 1 below).

../_images/monitoring-organizations-consumption-1.png

At the top of the Consumption page, you’ll find the summary of your plan & current consumption.

Plan details

The left metric (see Mark 1 below) shows the details of your current plan. At the top you will see the name of your plan type, as well as the start and end dates of your plan period. If your plan includes usage limits (e.g. commitments on an Enterprise plan) your commitment details will be shown below.

Processed data

The center metric (see Mark 2 below) shows an aggregated summary of your processed data across Workspaces. This is aggregated across all billable Workspaces included in your plan. Processed data is cumulative over the plans billing period.

Storage

The center metric (see Mark 3 below) shows an aggregated summary of your current storage across Workspaces. This is aggregated across all billable Workspaces included in your plan. Storage is the maximum storage used in the past day.

For both the Processed data and Storage metrics, the summary covers the current billing period. For Enterprise plans this covers the term of your current contract. For monthly plans, it is the current month.

../_images/monitoring-organizations-consumption-2.png

Below the summary you will find a breakdown of Processed data and Storage per Workspace. The calculation of these metrics is the same as explained above for the summary section, but on an individual Workspace basis.

Note that only billable Workspaces are included in this view. Non-billable Workspaces are included in the Workspaces tab.

In the left column of the table (see Mark 1 below) is the name of the Workspace. The center column of the table (see Mark 2 below) is the Processed data. The right column of the table (see Mark 3 below) is the Storage.

../_images/monitoring-organizations-consumption-3.png

Monitoring Workspaces¶

On this page you will find details about all of your Workspaces, their consumption, and whether they are billable or not.

You can navigate to this page by clicking the Workspaces tab in the left side nav bar (see Mark 1 below).

../_images/monitoring-organizations-workspaces-1.png

Using the date range selector at the top of the page, you can adjust the time period of the data displayed in the table.

The table on this page shows the following information:

Workspace name

The first column (see Mark 1 below) is the Workspace name.

Processed data

The center left column (see Mark 2 below) shows the processed data of the Workspace. Processed data is cumulative over the selected time range.

Storage

The center right column (see Mark 3 below) shows the current storage of the Workspace. Storage is the maximum storage used on the last day of the selected time range.

Billable

The final column (see Mark 4 below) shows whether the Workspace is billable or not. Usage in a billable Workspace counts towards your billing plan.

../_images/monitoring-organizations-workspaces-2.png

To add a new Workspace to your Organization, please contact support@tinybird.co.

Monitoring members¶

On this page you will find details about your Organization members, the Workspaces they belong to and their roles.

You can navigate to this page by clicking the Members tab in the left side nav bar (see Mark 1 below).

../_images/monitoring-organizations-members-1.png

The table on this page shows the following information:

Email

The first column (see Mark 1 below) is the user’s email address.

Workspaces and roles

The last column (see Mark 2 below) shows a summary of the Workspaces the user belongs to.

../_images/monitoring-organizations-members-2.png

To view the detail of a member’s Workspaces and roles, click the arrow next to the Workspace count (see Mark 1 below). The Workspace name is shown on the left (see Mark 2 below) and the member’s role on the right (see Mark 3 below).

../_images/monitoring-organizations-members-3.png

Monitoring APIs¶

On this page you will find details about the APIs that enable you to export, or integrate external tools with, your consumption data.

Usage of the Monitoring APIs is free.

You can navigate to this page by clicking the Monitoring APIs tab in the left side nav bar (see Mark 1 below).

../_images/monitoring-organizations-monitoring-apis-1.png

There are two APIs available:

Processed data

The first API (see Mark 1 below) shows a daily aggregated summary of your processed data per Workspaces.

Storage

The last API (see Mark 2 below) shows a daily aggregated summary of your current storage per Workspaces.

../_images/monitoring-organizations-monitoring-apis-2.png

You can select the time frame by editing the parameters in the url.

Processed data¶

Field

Type

Description

day

DateTime

Day of the record

workspace_id

String

ID of the Workspace.

read_bytes

UInt64

Bytes read in the Workspace that day

written_bytes

UInt64

Bytes written in the Workspace that day

Storage¶

Field

Type

Description

day

DateTime

Day of the record

workspace_id

String

ID of the Workspace.

bytes

UInt64

Maximum Bytes stored in the Workspace that day

bytes_quarantine

UInt64

Maximum Bytes stored in the Workspace quarantine that day