Organizations¶
Organizations provide a centralized way of managing Workspaces and members in a region. From the Organization settings section you can monitor resource usage and check your current plan's usage and billing if you're on a paid plan. See Plans.
The Organization settings screen consists of the following areas:
- Billing (Org admins only)
- Usage
- Workspaces
- Members
- Monitoring
All Workspaces must belong to an organization in Tinybird. See Workspaces.
Tinybird represents organizations using the icon.
Users and organizations¶
Users can be members of one or more organizations. A user can only be the admin of one organization.
Access the organization settings¶
To access the Organization settings screen, log in and select your organization name from a Workspace.
You can also access the screen by selecting Organization settings in the settings screen of a Workspace.
Billing¶
The Billing page contains a summary of the credits balance for your plan, with links to billing details and a summary of your plan. See Billing.
Free and Developer plans¶
From the Billing page you can upgrade or resize your plan, or cancel it if you wish to downgrade to Free.
If you're on a Developer plan, the usage diagram shows the total expenditure by monthly invoice.
Only organization administrators can access the Billing section.
Enterprise plans¶
The Credits usage section shows a chart with your credits usage over time and a forecast.
Usage overview¶
The Usage page shows details about your resource usage, followed by a detailed breakdown of your consumption.
Usage charts¶
The following charts are available depending on your plan:
| Plan | Charts |
|---|---|
| Free | vCPU time, Memory, Queries per Second, Errors |
| Developer | vCPU time, Memory, Queries per Second, Errors |
| Enterprise (Shared infrastructure) | vCPU time, Memory, Queries per Second, Errors |
| Enterprise (Dedicated infrastructure) | Load, Memory, Requests per Second, Errors |
You can select between average and maximum values for all usage charts, as well as the period, from Last hour to Last 7 days.
Usage table¶
The Usage table shows resource usage by Workspace or resource. You can filter by resource name by typing in the text box.
Workspaces¶
The Workspaces page shows details of all your Workspaces, including their name, members, and resources used by each Workspace.
New Workspaces created by a user with an email domain linked to, or matching an organization are automatically added to that organization.
Members¶
The Members page shows details of your organization members, the Workspaces they belong to, and their roles. From this page you can manage existing members, their permissions, or invite new members.
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.
Add or remove members¶
To add a user, select Add member.
To remove a user from the organization, select Remove member in the menu.
Only organization administrators can manage users in the Members page.
Add an admin¶
To add another user as an organization administrator, follow these steps:
- Navigate to the Organization settings page.
- Go to the Members section.
- Locate the user you want to make an administrator.
- Select the More actions (⋯) icon.
- Select Organization admin in the menu.
This grants organization administrator access to the selected users.
Monitoring¶
The Monitoring page provides customized code snippets to monitor usage using the Tinybird API and the Service Data Sources. See Organization Service Data Sources.
Prometheus metrics endpoint¶
The Prometheus endpoint is available at /v0/metrics. Use your organization's observability Token, which you can find in the Prometheus tab under Monitoring, Organization settings.
Tinybird reports all the metrics available in the service Data Source, except for InstanceType, which is reported as a metric label.
Refreshing your organization's Observability Token¶
If your organization's observability Token gets compromised or is lost, refresh it using the following endpoint:
/v0/organizations/<organization-id>/tokens/Observability%20%28builtin%29/refresh?token=<your-user-token>
You must use your user token for this call, which you can copy from any of your workspaces.