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).
The Organizations page will open onto the Consumption tab by default.
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).
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.
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.
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).
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.
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).
The table on this page shows the following information:
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.
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).
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).
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.
You can select the time frame by editing the parameters in the url.
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 |
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 |
