Introduction
Migrating to the cloud promised simplicity, but for many enterprises, it has introduced new layers of complexity. Infrastructure data often ends up scattered across silos, making it nearly impossible to get a unified view of hybrid and multi-cloud environments. Platform teams struggle to track ownership, security patching becomes more difficult, and costs spiral upward. HCP Terraform powered by Infragraph addresses these challenges with a centralized, event-driven knowledge graph that provides dynamic, real-time visibility into your entire infrastructure estate.
This guide walks you through the steps to get started with Infragraph within HCP Terraform, now available in public preview for qualified US customers. By the end, you'll understand how to break free from static, outdated data and empower your team with actionable insights.
What You Need
- An active HCP Terraform account with an appropriate plan (public preview eligibility applies to qualified US customers).
- Administrative access to configure integrations and view infrastructure resources.
- Access to one or more cloud providers (AWS, Azure, GCP) or on-premises systems that you want to map into the knowledge graph.
- Basic familiarity with HashiCorp Terraform workflows and cloud resource management.
- A clear understanding of your current reporting and compliance requirements (optional but helpful for prioritization).
Step-by-Step Guide
Step 1: Assess Your Current Infrastructure Visibility Gaps
Before diving into the setup, take a moment to evaluate how your team currently tracks assets. Identify the pain points:
Are you relying on multiple disjointed tools? Do you have “dirty data” from manual exports? How often do you need to consolidate information to get a snapshot?
Document the specific resources, ownership, and security events that matter most. This will help you prioritize which data sources to connect first and what insights you need from Infragraph.
Step 2: Confirm Your Eligibility for the Public Preview
HCP Terraform powered by Infragraph is currently in public preview for qualified US HCP Terraform customers. Visit the HashiCorp Cloud Platform portal to check if your organization has been granted access. If not, you may need to sign up for the preview program through your account representative. Ensure that your Terraform workspace is set up for the preview so you can activate the feature in the next steps.
Step 3: Enable Infragraph Within Your HCP Terraform Environment
Once eligibility is confirmed, log into your HCP Terraform account and navigate to the Infrastructure or Integrations section. Look for the “Infragraph” toggle or setup wizard. Click Enable. The system may request permissions to read metadata from your existing Terraform workspaces and linked providers. Grant the necessary permissions to allow Infragraph to start building the knowledge graph from your real-world infrastructure state.
Step 4: Connect Your Data Sources
Infragraph thrives on data from the full estate, not just Terraform state files. Use the configuration interface to add your cloud accounts (e.g., AWS Organizations, Azure Subscriptions, GCP Projects) and any on-premises tools that expose APIs. For each source, specify the regions and resource types you want to include.
The system will begin an initial sync, pulling resource definitions, tags, relationships, and security metadata. This process may take time depending on the size of your infrastructure. Monitor the sync status in the dashboard.
Step 5: Explore the Unified Knowledge Graph
After data ingestion, open the Infragraph Explorer (within HCP Terraform). You'll see a visual map of your resources – servers, databases, VMs, containers – connected by relationships such as “depends on,” “hosted on,” or “managed by.” This is your single source of truth. Use the search bar to filter by resource type, owner, or region. Click on any node to see real-time attributes and any changes that occurred.
This dynamic view replaces the static dashboards you may have used before. For example, if a security patch was applied to a server, the graph updates instantly.
Step 6: Set Up Dynamic Alerts and Dashboards
To move from visibility to action, configure alerts based on the knowledge graph. For instance, create a rule that triggers when a critical asset is missing a required tag or when an unpatched vulnerability is detected. You can build custom dashboards that show cost anomalies, security posture trends, or resource ownership.
These alerts are event-driven because Infragraph continuously ingests changes from your connected sources. No more waiting for stale reports – you receive notifications in near real-time.
Step 7: Leverage Insights for Automation (Future-Proofing)
While the initial preview focuses on visibility, the foundation is being built for AI-powered automation. Start by exploring how the knowledge graph can feed into your existing Terraform workflows. For example, use the graph to identify unused resources that can be decommissioned, or to enforce compliance policies before deploying new infrastructure. As HashiCorp evolves the feature, you'll be able to trigger Terraform runs based on graph events, reducing manual intervention.
Tips for Success
- Start small, then scale: Connect a handful of critical resources first to validate that the graph meets your needs before onboarding your entire estate.
- Clean up existing data: Before enabling Infragraph, delete unnecessary Terraform state versions and unused workspaces. This reduces noise and improves graph accuracy.
- Assign ownership tags: Ensure your resources have consistent tagging (e.g.,
owner,cost-center,environment). Infragraph leverages these tags to display ownership and responsibility. - Educate your platform team: Hold a brief training session to walk through the Infragraph interface. Explain how to interpret relationships and how to use dynamic alerts to reduce incident response times.
- Monitor preview changes: As the feature is in public preview, HashiCorp may update APIs or introduce breaking changes. Subscribe to release notes and plan for minor adjustments.
- Plan for compliance audits: Use the knowledge graph to generate on-demand reports that demonstrate your infrastructure state at a specific point in time, which can simplify audit evidence.
- Combine with cost analytics: Infragraph’s visibility into resource usage can help you spot cost spikes faster. Pair it with HCP Terraform’s cost estimation features to get a full picture.
By following these steps, your platform team can finally achieve the unified, real-time infrastructure visibility that the cloud era demands. HCP Terraform powered by Infragraph turns static silos into a living knowledge graph, helping you secure, optimize, and scale with confidence.