Organizations¶
The Tinybird organizations feature is only available to Enterprise or Dedicated plan customers.
Organizations provide a centralized way of managing Workspaces and members in a region. From the Organizations section you can monitor resource usage and check your current plan's usage and billing if you're on an Enterprise or Dedicated plan. See Plans.
The Organizations screen consists of the following areas:
- Billing
- Overview
- Workspaces
- Members
- Monitoring
Tinybird represents organizations using the icon.
Access the organizations section¶
To access the Organizations section, log in as an administrator and select your Workspace name, then select your organization name.
Usage overview¶
The Usage page shows details about your platform usage against your billing plan commitment followed by a detailed breakdown of your consumption. Only billable Workspaces are in this view. Find non-billable Workspaces in the Workspaces tab.
Processed data¶
The first metric 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 plan's billing period.
Storage¶
The second 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 third metric 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, for example 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's the current month.
After the summary, the page shows a breakdown of Processed data and Storage per Workspace and Data Source. The calculation of these metrics is the same as previously explained for the summary section, but on an individual basis.
Workspaces¶
This page displays details of all your Workspaces, their consumption, and whether they're billable or not. Using the date range selector at the top of the page, you can adjust the time 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.
New Workspaces that are created by a user with an email domain linked to (or matching) an Organization are automatically added to that Organization. The new Workspace then automatically shows up here in your Organization's Consumption metrics and listed Workspaces.
To delete a Workspace, select the checkbox of a Workspace name, followed by the Delete button. You don't need to be a user in that Workspace to delete it.
Members¶
Members shows details of your Organization members, the Workspaces they belong to, and their roles.
User roles:
- Admins can do everything in the Workspace.
- Guests can do most things, but they can't delete Workspaces, invite or remove users, or share Data Sources across Workspaces.
- Viewers can't edit anything in the main Workspace Branch, but they can use Playgrounds to query the data, as well as create or edit Branches.
The table shows the following information:
- Workspaces and roles
To view the detail of a member's Workspaces and roles, select the arrow next to the Workspace count. A 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 don't need to be a user in that Workspace to make changes to its users. As mentioned, you can also make a user an organization admin from this page.
To remove a user from the organization, select Remove member in the menu.
You can see if there are Workspaces where that user is the only admin and if the Token associated to the email has had activity in the last 7 days.
Add an organization admin¶
To add another user as an organization administrator, follow these steps:
- Navigate to the Your organization page.
- Go to the Members section.
- Locate the user you want to make an administrator.
- Select Organization Admin next to their name.
This grants administrator access to the selected users.
Monitoring endpoints¶
To monitor the usage of your Organization use the Organization Service Data Sources.
The endpoints page shows details about the APIs that allow you to export, or integrate external tools with, your usage data.
There are two APIs available: Processed data and Storage.
Processed data ¶
The first API shows a daily aggregated summary of your processed data per Workspaces.
Storage ¶
The last API shows a daily aggregated summary of your current storage per Workspaces. You can select the time 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 |
Dedicated infrastructure monitoring¶
The following features are in public beta and may change without notice. If you have feedback or suggestions, contact Tinybird at support@tinybird.co or in the Community Slack.
If your organization is on an infrastructure commitment plan, Tinybird offers two ways of monitoring the state of your dedicated clusters: using the organization.metrics_logs service Data Source, or through the Prometheus endpoint /v0/metrics, which you can integrate with the observability platform of your choice.
Billing dashboard¶
You can track your credits usage from the Billing section under Your organization. The dashboard shows your cumulative credits usage and estimated trend against the total, and warns you if you're about to run out of credits. For more details, you can access your customer portal using the direct link.
Cluster load chart¶
You can check the current load of your clusters using the chart under Your organization, Usage. Select a cluster in the menu to see all its hosts, then select a time. Each line represents the CPU usage of the host. When you select a host, the dotted line represents the total amount of CPUs available to the cluster.
