Configuration

Configure and manage your Qplane deployment. The cloud control plane provides centralized configuration for all connected Qtap agents across your organization.

New to Qplane? Start with the Getting Started guide which walks through the installation wizard and initial setup.


How Qplane Configuration Works

In cloud-connected mode, your Qtap agents connect to Qplane at app.qpoint.io to receive their configuration. Key principles:

  • Organization-wide configuration: Stacks, plugins, routing rules, and filters apply to all installations within an organization

  • Real-time updates: Changes propagate to connected agents within a minute

  • No restarts required: Agents apply new configuration automatically

  • Environment identification: Use installations to identify different environments (prod, staging, dev)


Configuration Topics

Structure your Qplane deployment using organizations, installations, and role-based access control.

Learn how to:

  • Organize your deployment (organizations vs installations)

  • Use RBAC roles to control team access

  • Implement multi-environment strategies

  • Choose the right access control pattern

Best for: Admins setting up team access and organizational structure


Configure how Qtap processes captured traffic using stacks and plugins.

Learn how to:

  • Create stacks for different traffic types

  • Configure plugins (Report Usage, Detect Errors, Access Logs, Qscan)

  • Set up domain-specific routing rules

  • Use the Reliability dashboard for error detection

Best for: Engineers configuring traffic capture and processing


Manage global settings, storage services, filters, and agent configuration.

Learn how to:

  • Configure traffic direction (egress-only in Qplane, ingress/all requires local YAML)

  • Set up object stores (S3, MinIO) for sensitive data

  • Filter out noisy processes

  • Manage installations and registration tokens

Best for: Operations teams managing infrastructure and data storage

Traffic Direction Limitations: Qplane currently supports egress traffic only (all outbound, external-only, or internal-only). To capture ingress or bidirectional (all) traffic, you must use local YAML configuration with standalone Qtap deployment.


Set up real-time alerts for API performance, reliability, and security events.

Learn how to:

  • Create alerting rules (critical latency, high error rates, vendor availability)

  • Configure integrations (webhooks, Slack, PagerDuty)

  • Filter alerts to reduce noise

  • Review alert events and history

Best for: SREs and on-call teams monitoring production traffic


Understand the complete Qpoint architecture and how all the pieces connect.

Learn about:

  • Data flow (events vs objects vs Qscan)

  • YAML configuration vs Qplane UI

  • Plugin architecture and processing pipelines

  • Control plane vs data plane responsibilities

Best for: Technical leads and architects understanding the full system


Quick Start

1. Already have agents deployed?

2. Need to configure data storage?

  • Go to Settings to set up S3-compatible object storage

3. Want to set up monitoring?

  • Jump to Alerting to configure rules and integrations

4. Understanding the system?


Common Configuration Tasks

Configure S3 storage for sensitive data:

  1. Navigate to Settings → Deploy → Services

  2. Add an S3-compatible object store (MinIO, AWS S3, GCS)

  3. Configure access credentials

  4. See Settings for details

Create a custom stack for specific traffic:

  1. Navigate to Plugins → Stacks

  2. Create a new stack with desired plugins

  3. Set up routing rules to assign domains to your stack

  4. See Stacks & Plugins for details

Set up team access control:

  1. Decide on your organization structure

  2. Invite team members with appropriate roles

  3. Create views for granular filtering (optional)

Configure error alerting:

  1. Navigate to Alerting → Rules

  2. Create or enable alerting rules

  3. Configure webhook/Slack integrations

  4. See Alerting for details


Last updated