Monitoring with Tinybird Organizations¶

The Tinybird Organizations section allows enterprise customers to monitor their consolidated Tinybird usage in one place. It provides a single dashboard for the overview of all Workspaces within an Organization, and enables specific Workspace-level actions. It includes dashboards for monitoring consumption of stor age and processed data, Workspaces, and Organization members. Consumption data is also available via a HTTP API.

Tinybird Organizations is split into 4 areas:

• Overview
• Workspaces
• Members
• Monitoring

Access the Organizations UI¶

You must be an Organization admin to access the Organizations UI. If you want to add someone else as an Organization admin to have access to this page, contact Tinybird in your shared Slack channel.

To access the Organizations UI, select your Workspace name at the top left of the Tinybird UI, then select your Organization name (below the Region name).

Consumption overview¶

The Overview page shows details about your platform usage against your billing plan commitment followed by a detailed breakdown of your consumption:

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

Processed data¶

The metric on the left shows an aggregated summary of your processed data. This is aggregated across all billable Workspaces included in your plan. Processed data is cumulative over the plans billing period.

Storage¶

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

Contract¶

The metric on the right shows the details of your current contract, including the plan type and start/end dates of your plan period. If your plan includes usage limits (e.g. commitments on an Enterprise plan) your commitment details are also shown here.

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, this page shows you a breakdown of Processed data and Storage per Workspace and Data Source. The calculation of these metrics is the same as explained above for the summary section, but on an individual basis.

Organization Service Data Sources¶

These charts are built using Organization Service Data Sources:

• organization.datasources_storage: similar to tinybird.datasources_storage but with data for all Organization Workspaces.
• organization.pipe_stats: similar to tinybird.pipe_stats but with data for all Organization Workspaces.
• organization.datasources_ops_log: similar to tinybird.datasources_ops_log but with data for all Organization Workspaces.
• organization.workspaces: lists all Organization Workspaces and related information (name, IDs, databases, plan, when it was created, and whether it was soft-deleted).
• organization.processed_data: information related to all processed data per day per workspace.

Only Organization Admins are able to run these queries. To query these Organization Service Data Sources, go to any Workspace that belongs to the Organization, and use these as you would a regular Service Data Source from the Playground or within Pipes. Use the admin user@domain token of an Organization Admin. You can also copy your user admin token and make queries using your preferred method, like tb sql.

Workspaces¶

This page displays details of all of your Workspaces, their consumption, and whether they are billable or not. 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 shows the following information:

• Workspace name
• Processed data: Processed data is cumulative over the selected time range.
• Storage: Storage is the maximum storage used on the last day of the selected time range.
• Plan type: Billable or free. Usage in a billable Workspace counts towards your billing plan.

To delete Workspace, select the checkbox to the left of a Workspace name, followed by the Delete button. You do not need to be a user in that Workspace to delete it.

Members¶

This page shows details of your Organization members, the Workspaces they belong to, and their roles.

The table on this page shows the following information:

• Email
• Workspaces and roles

To view the detail of a member’s Workspaces and roles, select the arrow next to the Workspace count. A dropdown menu shows all the Workspaces that user is part of, plus their role in each Workspace.

To change a user’s role or remove them from a Workspace, hover over the Workspace name and follow the > arrow. Select a new role from “Admin”, “Guest”, or “Viewer”, or remove them from the Workspace. You do not need to be a user in that Workspace to make changes to its users.

Monitoring endpoints¶

This shows details about the APIs that enable you to export, or integrate external tools with, your consumption data.

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.

Processed data

Storage