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 python@3.13
    
  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

Support

If you need help or more information about this integration, please contact support@rootly.com or use the lower right chat widget to get connected with an engineer.