Drasi on Drasi Docs

Getting Started Path

Mon, 01 Jan 0001 00:00:00 +0000

New Users 2-3 hours total

Perfect for newcomers to Drasi for Kubernetes. This path takes you from zero to a working continuous query solution.

Tutorial

Install Drasi on Kubernetes

Set up Drasi on your Kubernetes cluster

10 min

Concept

Understand Core Concepts

Learn what Sources, Queries, and Reactions do

15 min

Reference

Query Language Reference

Deep dive into Cypher and Drasi functions

Reference

What You’ll Learn

By completing this path, you will:

Quick Start Path

Mon, 01 Jan 0001 00:00:00 +0000

New Users 1-2 hours total

Perfect for newcomers to Drasi Server. This path takes you from zero to a working reactive query solution.

Tutorial

Getting Started with Drasi Server

Install and run your first query

15 min

Concept

Understand Core Concepts

Learn what Sources, Queries, and Reactions do

15 min

Tutorial

SLA Breach Alerting

Build time-based alerts with multi-table joins

30 min

Tutorial

Smart Reorder Recommendations

Complex queries with aggregations and computed fields

Developer Path

Mon, 01 Jan 0001 00:00:00 +0000

Developers 3-4 hours total

Build practical applications with Drasi Server. This path takes you through real-world development scenarios.

Tutorial

Complete Getting Started

Ensure Drasi Server is running

15 min

How-to

Configure PostgreSQL Source

Connect to PostgreSQL with CDC

20 min

Tutorial

Build Live Order Dashboard

Create a real-time operations dashboard

60 min

How-to

What You’ll Learn

By completing this path, you will:

Real-World Developer Path

Mon, 01 Jan 0001 00:00:00 +0000

Developers 4-6 hours total

Build practical, production-ready solutions. This path takes you through a complete real-world scenario with best practices.

Tutorial

Complete Getting Started

Ensure Drasi is running on your cluster

10 min

Tutorial

Building Comfort Tutorial

Build a real-time HVAC monitoring system

60 min

How-to

Configure PostgreSQL Source

Connect to production PostgreSQL

20 min

How-to

Configure SignalR Reaction

Build real-time UI updates

20 min

Tutorial

Operations Path

Mon, 01 Jan 0001 00:00:00 +0000

DevOps / SRE 3-4 hours total

Everything you need to deploy, monitor, and maintain Drasi for Kubernetes in production environments.

How-to

Installation Options

Choose your Kubernetes platform

30 min

How-to

AKS Deployment

Production deployment on Azure

30 min

How-to

Observability Setup

Configure metrics and tracing

30 min

How-to

Monitoring Guide

Set up alerting and dashboards

30 min

How-to

Scaling Strategies

Scale for production workloads

30 min

How-to

What You’ll Learn

By completing this path, you will:

Operations Path

Mon, 01 Jan 0001 00:00:00 +0000

DevOps / SRE 2-3 hours total

Everything you need to deploy and operate Drasi Server in production environments.

How-to

Installation Options

Choose your deployment method

15 min

How-to

Docker Compose Deployment

Production deployment with Docker Compose

20 min

How-to

Configuration File Setup

Create production configuration

20 min

How-to

Operations Guide

Monitoring and troubleshooting

30 min

Reference

What You’ll Learn

By completing this path, you will:

Architecture Path

Mon, 01 Jan 0001 00:00:00 +0000

Architects 2-3 hours total

Deep understanding of Drasi architecture and design patterns for enterprise Kubernetes solutions.

Concept

Continuous Queries Deep Dive

Understand the query execution model

20 min

Pattern

Solution Architecture Patterns

Reference architectures for common scenarios

30 min

Pattern

What You’ll Learn

By completing this path, you will:

Architecture Path

Mon, 01 Jan 0001 00:00:00 +0000

Architects 2-3 hours total

Deep understanding of Drasi architecture and design patterns for Drasi Server solutions.

Concept

Continuous Queries Deep Dive

Understand the query execution model

20 min

Pattern

Solution Architecture Patterns

Reference architectures for common scenarios

30 min

Pattern

What You’ll Learn

By completing this path, you will:

Integration Path

Mon, 01 Jan 0001 00:00:00 +0000

Developers 2-3 hours total

Learn how to integrate Drasi for Kubernetes with your existing systems and build custom extensions.

Concept

Source Types Overview

Understand available source types

15 min

Concept

Reaction Types Overview

Understand reaction options

15 min

Tutorial

Event-Driven Reactions

Send events to Azure Event Grid

20 min

Tutorial

Integration Path

Mon, 01 Jan 0001 00:00:00 +0000

Developers 2-3 hours total

Learn how to integrate Drasi Server with your existing systems using various source and reaction types.

Concept

Source Types Overview

Understand available source types

15 min

How-to

Configure Platform Source

Receive events from Redis streams

15 min

How-to

Implement a Source

Mon, 01 Jan 0001 00:00:00 +0000

Source proxy

The Source proxy is responsible for bootstrapping the initial data when a continuous query is deployed.
For any source proxy, we need to set up an HTTP server that listens for a POST request on the route ‘/acquire’. The bootstrap logic will be implemented under this section. As a result, when a POST request is received, the initial data will be obtained based on the logic here.
- For example, the SQL proxy uses knex to query and retrieve all of the rows in a SQL table and use the data as the bootstrapping data.
- It is also worth noting that the passthru proxy might be useful in certain situations. The passthru proxy handles the bootstrapping process by using dapr to invoke a HTTP Post method called “acquire”, which is defined in the Source reactivator.

Sample code block:

Cypher Query Language

Mon, 01 Jan 0001 00:00:00 +0000

Continuous Queries Continuous Query A query that runs continuously, maintaining an always-current result set as data changes. Learn more are written using a subset of the Cypher Query Language openCypher A declarative graph query language used to write Drasi Continuous Queries. Learn more . If you are new to Cypher, Neo4J the original creators of the Cypher Query Language, have a lot of resources to help you understand, learn, and try Cypher, including:

Implement a Reaction

Mon, 01 Jan 0001 00:00:00 +0000

You can develop custom reactions by writing an application in any language that adheres to a certain specification and publish it as a docker image to the registry serving Drasi images to your cluster.

Query Configuration

The Drasi control plane will mount a folder at /etc/queries where each file will be named after each queryId that is configured for the reaction. The contents of each file will be the options field from the config.

Setup PostgreSQL Replication

Mon, 01 Jan 0001 00:00:00 +0000

This page describes how to configure your PostgreSQL database so it will work with the PostgreSQL Source Source A connection to an external system that Drasi monitors for data changes. Learn more . This is a summary of the Debezium documentation originally published under the Apache 2.0 License. The original documentation can be found at debezium.io. This documentation is licensed under the Apache 2.0 License.

Sources

Mon, 01 Jan 0001 00:00:00 +0000

Sources ingest data from external systems or your application and emit graph elements (nodes and relationships) that feed into Continuous Queries. Each Source is a separate crate that you add to your Cargo.toml as needed.

Available Sources

Application

Push changes directly from your application code

gRPC

High-throughput streaming via gRPC with bidirectional support

HTTP

Receive change events via HTTP webhooks

Mock

Generate test data for development and testing

Graph Query Language (GQL)

Mon, 01 Jan 0001 00:00:00 +0000

GQL Support

Drasi supports a subset of the Graph Query Language GQL An ISO-standard graph query language supported by Drasi for Continuous Queries. Learn more (GQL) ISO standard for querying graph databases. This subset includes the core statements and functions needed for continuous query Continuous Query A query that runs continuously, maintaining an always-current result set as data changes. Learn more processing.

Reactions

Mon, 01 Jan 0001 00:00:00 +0000

Reactions respond to changes in Continuous Query results and trigger actions, such as sending webhooks, logging, updating databases, or calling back into your application. Each Reaction is a separate crate that you add to your Cargo.toml as needed.

Available Reactions

Application

Handle query result changes directly in your application code

gRPC

Stream query results via gRPC to external services

HTTP

Send webhooks to external endpoints on query result changes

Setup MySQL

Mon, 01 Jan 0001 00:00:00 +0000

This page describes how to configure your MySQL database to work with the Drasi MySQL source Source A connection to an external system that Drasi monitors for data changes. Learn more . This is a summary of the Debezium v2.7 documentation originally published under the Apache 2.0 License. The original documentation can be found at debezium.io. This documentation is licensed under the Apache 2.0 License.

Drasi Custom Functions

Mon, 01 Jan 0001 00:00:00 +0000

Drasi is not simply running graph queries across data, it is using the Cypher Query Language openCypher A declarative graph query language used to write Drasi Continuous Queries. Learn more or GQL GQL An ISO-standard graph query language supported by Drasi for Continuous Queries. Learn more as a convenient way to express the data you want to observe for changes. Drasi provides the following functions that extend the base Cypher Query Language and GQL in order to meet its needs for detecting and reacting to change (or an absence of change).

Setup SQL Server

Mon, 01 Jan 0001 00:00:00 +0000

This page describes how to configure your SQL Server database to work with the Drasi SQL Server source Source A connection to an external system that Drasi monitors for data changes. Learn more . This is a summary of the Debezium documentation originally published under the Apache 2.0 License. The original documentation can be found at debezium.io. This documentation is licensed under the Apache 2.0 License.

Connecting a React App to a Query

Mon, 01 Jan 0001 00:00:00 +0000

ReactJS

React components for connecting to a Drasi SignalR Reaction Reaction A component that receives query result changes and takes action on them. Learn more are published on NPM.

A basic React App has been created using create-react-app, under the 02-connect-frontends/react directory. This app will use these components to connect to a SignalR hub and display the results Result Set The current output of a Continuous Query, updated automatically as data changes. Learn more of a query Continuous Query A query that runs continuously, maintaining an always-current result set as data changes. Learn more in real time.

Connecting a Vue App to a Query

Mon, 01 Jan 0001 00:00:00 +0000

VueJS

Vue components for connecting to a Drasi SignalR Reaction Reaction A component that receives query result changes and takes action on them. Learn more are published on NPM.

A basic Vue App has been created under the 02-connect-frontends/vue directory. This app will use these components to connect to a SignalR hub and display the results Result Set The current output of a Continuous Query, updated automatically as data changes. Learn more of a query Continuous Query A query that runs continuously, maintaining an always-current result set as data changes. Learn more in real time.