DOCSEARCHbyAlgolia
Submit Docs

StackGen Documentation

website·Indexed 34 days ago

https://docs.stackgen.com

Documentation and release notes for StackGen and Aiden, featuring tools for SRE alert triage, infrastructure management, and DevOps automation. Includes details on MCP configurations, LLM gateways, functional agents, and integrations with GitHub, Slack, PagerDuty, and Azure.

Tokens
240.5K
Snippets
624
Records
1.7K
Agent score
60%

What's inside StackGen

  1. Overview of StackGen and HCP Terraform Integration

    StackGen integrates with HCP Terraform to combine visual infrastructure design (appStacks) with Terraform's remote state management, policy enforcement, and governance. Users design infrastructure visually in StackGen, which then generates production-ready Terraform HCL configured for an HCP Terraform backend. Key capabilities include automatic HCL generation, built-in security validation during design, support for multi-region/multi-environment setups via workspaces, and the ability to import existing .tfstate files.

  2. Overview of appStack-owned custom modules

    appStack-owned custom modules are stored within a single appStack. When these modules are edited and published, StackGen automatically refreshes every instance of that module on the Topology canvas. This eliminates the need to delete and re-add nodes or re-upload files when changing Terraform source code (e.g., .tf files), adding infrastructure, or exposing new input parameters. Existing attribute values saved on canvas nodes are preserved during the update process.

  3. Overview of StackGen appStacks

    An appStack is a collection of resources representing an application or cloud system. StackGen uses appStacks to analyze application architecture and generate the corresponding Infrastructure as Code (IaC) required for deployment. The general workflow for generating IaC involves logging in, creating an appStack, viewing/editing the topology, and generating the IaC files.

  4. Overview of Shared Dashboards in StackGen ObserveNow

    The Shared Dashboards module allows users to share curated, customer-specific observability dashboards with external stakeholders. Dashboards are created in Grafana and then imported into the Shared Dashboards module. Shared links are read-only and scoped via predefined variables to ensure recipients only see authorized data. Updates made in Grafana are automatically reflected in the shared dashboard upon the next load.

  5. Overview of StackGen Model Context Protocol (MCP)

    The Model Context Protocol (MCP) allows AI assistants (such as Claude, Cursor, and VS Code) to interact with StackGen APIs using a standardized tool list. This enables models to access live infrastructure state, perform in-product actions (like creating/deleting custom modules), manage appStack snapshots, and update environment configurations. Access is authenticated via a StackGen Personal Access Token (PAT), and the available tools are dynamically filtered based on the permissions associated with that token.

  6. Overview of Shared Infrastructure in StackGen

    Shared Infrastructure allows StackGen to extract output values (such as VPC IDs, subnet IDs, or security group IDs) from a provisioned appStack's Terraform state (tfstate) and make them available to other appStacks or projects. This enables dependent appStacks to reference resources from a central networking or infrastructure stack without needing to redeploy the original resources.

  7. Overview of Notification Channels

    Notification channels are reusable delivery targets used for schedule and webhook run notifications. They are configured at the Workspace scope and are accessible to users with the Admin or Workspace Admin roles. To manage them, navigate to Workspace Settings -> Connections -> Notification channels.

  8. Overview of the StackGen Project Dashboard

    The Project Dashboard serves as the project-level landing page for monitoring project health and completing setup tasks. It provides a centralized view of key project metrics and follow-up actions, allowing administrators to identify areas that require attention without navigating through multiple pages.

  9. Overview of StackGen ObserveNow Alerting

    StackGen ObserveNow provides a proactive alerting system that connects data collection to action. It uses Grafana as the primary alerting tool and also supports Prometheus Alertmanager.

  10. Overview of Aiden GCP Integration capabilities

    Integrating Aiden with Google Cloud Platform (GCP) allows users to manage cloud resources through natural language conversations. Key capabilities include:

    • Monitoring and managing virtual machines and compute resources.
    • Tracking storage accounts and fetching their sizes.
    • Analyzing virtual network configurations.
    • Optimizing cloud resource utilization.
    • Analyzing GCP billing and costs.
    • Reviewing IAM permissions and policies.

  11. Overview of PagerDuty integration for Aiden

    Integrating PagerDuty with Aiden allows users to manage incidents, on-call rotations, and escalation policies through natural language conversations. Key capabilities include:

    • Listing and filtering incidents by status, urgency, and date.
    • Creating and resolving incidents, including adding notes and responders.
    • Viewing on-call schedules and current on-call users.
    • Managing escalation policies, services, and teams.
    • Analyzing incident patterns and identifying related or outlier incidents.

  12. Overview of Aiden AlertManager integration

    The AlertManager integration allows Aiden to connect to a Prometheus Alertmanager instance. This enables users to conversationally inspect active alerts, manage silences, and understand alert routing without manually navigating the Alertmanager UI or parsing configuration files.