Opsgenie connector
Set up the Opsgenie connector in Kaivo: authentication, configuration, the 9 BigQuery tables it syncs, and answers to common questions.
Opsgenie connector pricing, tier and credits on kaivo.ioKaivo is a fully managed data platform that syncs your Opsgenie data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your data from Opsgenie instead of moving it.
What is the Opsgenie connector
Section titled “What is the Opsgenie connector”Sync your Opsgenie alerting data into BigQuery with Kaivo to analyse alerts, incidents, and on-call load over time.
| Category | Tech |
|---|---|
| Authentication | API key |
| Setup | Self-service |
Getting started with the Opsgenie connector
Section titled “Getting started with the Opsgenie connector”- Sign up for Kaivo and create a workspace.
- Connect your Opsgenie account.
- Choose which tables to sync.
- Wait for the initial sync to finish.
- Query your data in BigQuery or your favourite AI or BI tool.
Authenticating Opsgenie
Section titled “Authenticating Opsgenie”Authenticate with your API Token.
| Field | Description |
|---|---|
| API Token | |
| Your Opsgenie API token. You can generate one in your Opsgenie account under Settings → API Key Management. |
|
Configuring the Opsgenie connector
Section titled “Configuring the Opsgenie connector”When you set up the connector, you provide:
| Field | Description |
|---|---|
| Region | |
| Select “EU” if your Opsgenie account is in the EU region; otherwise leave as “US”. |
| | Start Date |
Any data before this date will not be fetched.
|
Tables and columns synced from Opsgenie
Section titled “Tables and columns synced from Opsgenie”Kaivo syncs 9 tables from Opsgenie into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.
alert_logs (8 columns)
| Column | Type | Description |
|---|---|---|
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
alert_id |
STRING |
Unique identifier for the alert |
offset |
STRING |
Offset value for tracking log position or pagination |
log |
STRING |
Details of the log entry |
type |
STRING |
Type or category of the log entry |
owner |
STRING |
Owner or user responsible for the log entry |
created_at |
TIMESTAMP |
Timestamp when the log entry was created |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
alert_recipients (10 columns)
| Column | Type | Description |
|---|---|---|
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
alert_id |
STRING |
Unique identifier for the alert associated with the recipient |
user_id |
STRING |
Unique identifier for the user associated with the recipient |
user_username |
STRING |
Username of the user associated with the recipient |
state |
STRING |
State of the alert recipient (active, inactive, etc.) |
method |
STRING |
Communication method used to notify the recipient |
aware |
BOOL |
Flag indicating whether the recipient is aware of the alert |
created_at |
TIMESTAMP |
Timestamp indicating when the recipient was created |
updated_at |
TIMESTAMP |
Timestamp indicating when the recipient information was last updated |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
alerts (31 columns)
| Column | Type | Description |
|---|---|---|
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
id |
STRING |
Unique identifier for the alert |
tiny_id |
STRING |
Short unique identifier for the alert |
alias |
STRING |
Alias of the alert |
message |
STRING |
Message associated with the alert |
note |
STRING |
Any additional notes or comments about the alert |
status |
STRING |
Current status of the alert |
acknowledged |
BOOL |
Indicates if the alert has been acknowledged by a team member |
seen |
BOOL |
Indicates if the alert has been seen by a team member |
is_seen |
BOOL |
Indicates if the alert has been viewed |
snoozed |
BOOL |
Indicates if the alert has been snoozed |
snoozed_until |
TIMESTAMP |
Timestamp until which the alert is snoozed |
count |
FLOAT64 |
Number of occurrences of the alert |
last_occurred_at |
TIMESTAMP |
Timestamp of the last occurrence of the alert |
source |
STRING |
Source from where the alert originated |
owner |
STRING |
Owner of the alert |
user |
STRING |
User associated with the alert |
priority |
STRING |
Priority level of the alert |
integration__id |
STRING |
Unique identifier for the integration |
integration__name |
STRING |
Name of the integration |
integration__type |
STRING |
Type of the integration |
report__ack_time |
FLOAT64 |
Timestamp when the alert was acknowledged |
report__close_time |
FLOAT64 |
Timestamp when the alert was closed |
report__acknowledged_by |
STRING |
Team member who acknowledged the alert |
report__closed_by |
STRING |
Team member who closed the alert |
entity |
STRING |
Entity associated with the alert |
description |
STRING |
Description of the alert |
owner_team_id |
STRING |
Identifier of the team that owns the alert |
created_at |
TIMESTAMP |
Timestamp when the alert was created |
updated_at |
TIMESTAMP |
Timestamp when the alert was last updated |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: alerts__tags
Section titled “Subtable: alerts__tags”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
value |
STRING |
|
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: alerts__responders
Section titled “Subtable: alerts__responders”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
id |
STRING |
Unique identifier for the responder |
type |
STRING |
Type of the responder |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: alerts__visible_to
Section titled “Subtable: alerts__visible_to”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
id |
STRING |
Unique identifier for the user or team |
name |
STRING |
Name of the user or team |
type |
STRING |
Type of the user or team |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: alerts__teams
Section titled “Subtable: alerts__teams”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
id |
STRING |
Unique identifier for the team |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: alerts__actions
Section titled “Subtable: alerts__actions”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
value |
STRING |
|
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
incidents (18 columns)
| Column | Type | Description |
|---|---|---|
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
id |
STRING |
Unique identifier for the incident. |
tiny_id |
STRING |
Short identifier for the incident. |
message |
STRING |
Brief summary or message related to the incident. |
note |
STRING |
Any additional notes or comments regarding the incident. |
description |
STRING |
A detailed description of the incident. |
status |
STRING |
Current status of the incident. |
priority |
STRING |
Priority level assigned to the incident. |
owner_team |
STRING |
Owner team of the incident. |
status_page_entry__title |
STRING |
Title or headline related to the incident status. |
status_page_entry__detail |
STRING |
Detailed status information. |
links__web |
STRING |
Web link related to the incident. |
links__api |
STRING |
API link related to the incident. |
impact_start_date |
TIMESTAMP |
The timestamp when the impact started for the incident. |
notify_stakeholders |
BOOL |
Flag indicating whether stakeholders should be notified about the incident. |
created_at |
TIMESTAMP |
The timestamp when the incident was created. |
updated_at |
TIMESTAMP |
The timestamp when the incident was last updated. |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: incidents__tags
Section titled “Subtable: incidents__tags”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
value |
STRING |
|
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: incidents__responders
Section titled “Subtable: incidents__responders”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
id |
STRING |
Unique identifier of the responder. |
type |
STRING |
Type or role of the responder. |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: incidents__impacted_services
Section titled “Subtable: incidents__impacted_services”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
value |
STRING |
|
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: incidents__actions
Section titled “Subtable: incidents__actions”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
integrations (9 columns)
| Column | Type | Description |
|---|---|---|
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
id |
STRING |
Unique identifier for the integration. |
name |
STRING |
Name of the integration. |
enabled |
BOOL |
Indicates if the integration is currently enabled or disabled. |
type |
STRING |
Type of integration (e.g., email, chat, webhook). |
team_id |
STRING |
Identifier for the team to which the integration belongs. |
version |
STRING |
Version of the integration. |
advanced |
BOOL |
Specifies if the integration has advanced settings enabled or not. |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
services (9 columns)
| Column | Type | Description |
|---|---|---|
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
id |
STRING |
Unique identifier for the service. |
name |
STRING |
The name of the service. |
description |
STRING |
The description of the service. |
team_id |
STRING |
Identifier of the team to which the service belongs. |
is_external |
BOOL |
Flag indicating whether the service is external. |
links__web |
STRING |
URL for the web interface of the service. |
links__api |
STRING |
URL for the API endpoint of the service. |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: services__tags
Section titled “Subtable: services__tags”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
value |
STRING |
Array of tags associated with the service. |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
teams (7 columns)
| Column | Type | Description |
|---|---|---|
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
id |
STRING |
Unique identifier for the team. |
name |
STRING |
Name of the team. |
description |
STRING |
Description of the team. |
links__web |
STRING |
Web link related to the team. |
links__api |
STRING |
API link related to the team. |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
user_teams (5 columns)
| Column | Type | Description |
|---|---|---|
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
user_id |
STRING |
Unique identifier for the user associated with the team. |
id |
STRING |
Unique identifier for the team. |
name |
STRING |
Name of the team. |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
users (19 columns)
| Column | Type | Description |
|---|---|---|
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
id |
STRING |
The unique identifier of the user. |
full_name |
STRING |
The full name of the user. |
username |
STRING |
The username or login name of the user. |
blocked |
BOOL |
Indicates whether the user is blocked or not. |
verified |
BOOL |
Indicates if the user account has been verified. |
role__id |
STRING |
The unique identifier of the user role. |
role__name |
STRING |
The name of the user role. |
time_zone |
STRING |
The time zone setting of the user. |
locale |
STRING |
The preferred locale or language setting of the user. |
user_address__country |
STRING |
The country of the user’s address. |
user_address__state |
STRING |
The state or region of the user’s address. |
user_address__city |
STRING |
The city of the user’s address. |
user_address__line |
STRING |
The street address line. |
user_address__zip_code |
STRING |
The ZIP code of the user’s address. |
invitation_disabled |
BOOL |
Indicates if the user is disabled from receiving invitations. |
skype_username |
STRING |
The user’s Skype username. |
created_at |
TIMESTAMP |
The date and time when the user account was created. |
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
Subtable: users__tags
Section titled “Subtable: users__tags”| Column | Type | Description |
|---|---|---|
_kaivo_parent_id |
STRING |
Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo. |
_kaivo_id |
STRING |
Primary key that uniquely identifies the row. Auto-generated by Kaivo. |
value |
STRING |
|
_kaivo_extracted_at |
TIMESTAMP |
Timestamp that shows when the row was extracted. Auto-generated by Kaivo. |
How the Opsgenie sync works
Section titled “How the Opsgenie sync works”After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Opsgenie supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won’t get duplicate rows.
Frequently asked questions
Section titled “Frequently asked questions”How long does the initial sync take for Opsgenie?
Section titled “How long does the initial sync take for Opsgenie?”It depends on how much history is in your Opsgenie account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they’re much faster.
Can I sync only some tables or columns?
Section titled “Can I sync only some tables or columns?”Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don’t select are never copied to your warehouse.
What happens when Opsgenie’s schema changes?
Section titled “What happens when Opsgenie’s schema changes?”New fields are never added automatically. You choose which fields to sync, so data you haven’t selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table’s sync mode: full-refresh tables always match what’s currently in Opsgenie, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.
How do I handle GDPR or data deletion requests?
Section titled “How do I handle GDPR or data deletion requests?”Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in Opsgenie instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the Opsgenie connector in Kaivo and all of its synced data is deleted with it.
Common use cases for Opsgenie data
Section titled “Common use cases for Opsgenie data”Alert trends
Section titled “Alert trends”Use alerts and alert_logs to track alert volume and noise over time.
Incident analysis
Section titled “Incident analysis”Join incidents with services to find the systems that page most.
On-call load
Section titled “On-call load”Use teams and user_teams to see how on-call load is shared.
Use Opsgenie data in your AI and BI tools
Section titled “Use Opsgenie data in your AI and BI tools”Once Opsgenie data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here’s how the most common destinations work with Opsgenie data.
Claude
Section titled “Claude”Use Kaivo’s MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →
Power BI
Section titled “Power BI”Microsoft’s BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →
Data Studio
Section titled “Data Studio”Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →
Tableau
Section titled “Tableau”The premium analytics standard, with native BigQuery integration. Setup guide →
Google Sheets
Section titled “Google Sheets”Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →
Connect via Power Query’s BigQuery connector. Setup guide →
Metabase
Section titled “Metabase”Open-source BI tool with strong BigQuery support. Setup guide →
See our pricing page for Opsgenie connector pricing and plan details.