Rootly Glean Connector

A Python integration that syncs Rootly incident management data with Glean for unified search and discovery.

Overview

This project creates a seamless connection between Rootly and Glean, enabling users to search for:

• Incidents - Active and resolved incidents with severity, status, and timeline data
• Alerts - Alert configurations and monitoring rules
• Schedules - On-call schedules with rotations, shifts, and user assignments
• Escalation Policies - Links to escalation rules and notification chains
• Retrospectives - Links to post-incident analysis

Quick Start

Requirements

• Python 3.13+

  # macOS (using Homebrew)
  brew install [email protected]

1. Clone and setup environment:

   git clone https://github.com/rootlyhq/rootly-glean-connector.git
   cd rootly-glean-connector
   python -m venv venv
   source venv/bin/activate

2. Install dependencies:

   pip install -r requirements.txt

3. Get secrets file: Create a secrets.env file containing:

   GLEAN_API_TOKEN=your_glean_api_token_here
   ROOTLY_API_TOKEN=your_rootly_api_token_here
   

4. Run the integration:

   python app.py

Configuration

Edit config.json to customize:

• Glean API host - Update glean.api_host to match your Glean server (default: support-lab-be.glean.com)
• Data type settings (enable/disable incidents, alerts, schedules, escalation policies, retrospectives)
• Item limits and pagination per data type
• Enhanced incident features (timeline events, action items)
• Logging levels and sync intervals

Configuration files:

• config.json - Contains non-sensitive configuration settings
• secrets.env - Contains API tokens

Architecture

• data_fetchers/: API clients for each Rootly data type
• document_mappers/: Convert Rootly data to Glean document format
• processors/: Sync coordination and orchestration
• glean_schema/: Glean document definitions

Glean Search Examples

Once synced, search for Rootly data in Glean:

Incidents

• "Find incidents with timeline events"
• "Show incidents with high severity that are resolved"

Schedules & On-Call

• "Show latest on-call schedule in rootly"

Alerts & Monitoring

• Show latest alerts in Rootly