CloudForge documentation

Operate CloudForge with clarity and confidence

Learn how to structure an investigation, review generated automation, manage technical context, and validate every production-facing recommendation.

Getting started

Quick start

CloudForge works best as an investigation partner. Give it enough technical context to distinguish likely causes, ask for evidence before changes, and verify the result in your environment.

01

Describe

Share the symptom, scope, environment, and recent changes.

02

Investigate

Collect logs and validate the most likely failure boundaries.

03

Act safely

Review impact, test, execute, monitor, and keep a rollback path.

Write a useful technical prompt

A precise prompt reduces guesswork. You do not need a perfect diagnosis; you need a clear account of what you can observe.

Environment
Subscription scope, region, service tier, runtime, and network model.
Symptom
Exact error, status code, affected operation, and when it began.
Impact
Who or what is affected, and whether production traffic is involved.
Recent change
Deployment, configuration, identity, DNS, certificate, or policy changes.
Evidence
Relevant logs, metrics, correlation IDs, timestamps, and commands already tried.
Prompt template
Environment: Azure App Service, Linux, West Europe, P1v3
Symptom: HTTP 502 began at 14:20 UTC after deployment
Impact: All production requests are failing
Recent change: New startup command and application settings
Evidence: Deployment succeeded; container exits after 30 seconds
Goal: Identify the safest investigation sequence before rollback

Manage investigations

Use one conversation for one problem so evidence, assumptions, and decisions remain connected. CloudForge stores conversation history so you can reopen an earlier investigation and continue from its existing context.

  • Use New Chat when you move to a different incident or environment.
  • Continue the same chat when new logs or test results belong to the current issue.
  • Stop generation when enough information is available or the investigation direction needs correction.
  • Do not paste secrets, access tokens, connection strings, or customer-sensitive data.

Troubleshooting workflow

Ask CloudForge to separate the system into failure boundaries before recommending changes. A good response should tell you what evidence to collect, what each result means, and what to try next.

  1. 1

    Confirm scope and timeline

    Establish what is failing, what still works, when it changed, and whether the issue is reproducible.

  2. 2

    Separate failure boundaries

    Distinguish application, identity, DNS, network, platform, deployment, and downstream dependency failures.

  3. 3

    Collect decisive evidence

    Prefer logs, metrics, health state, configuration snapshots, and timestamped test results over assumptions.

  4. 4

    Change one variable

    Use the smallest reversible action that tests the leading hypothesis, then observe the result.

  5. 5

    Verify recovery

    Confirm service health, business behavior, monitoring, and any temporary controls after the fix.

Automation safety

Generated commands are a draft for review, not an authorization to change an environment. Ask for an explanation of every parameter and adapt identifiers, scope, and safeguards to your organization.

Before running a command

Confirm the active account and subscription, inspect the target resources, understand side effects, test in a safe scope, prepare rollback, and capture the before-state.

Request a read-only discovery command first.
Ask for idempotency and error-handling behavior.
Use what-if, plan, validate, or dry-run modes where available.
Define success signals and post-change monitoring.

Supported engineering areas

CloudForge is focused on Microsoft Azure and the operational tools commonly used around it.

Compute & apps

App Service, Functions, virtual machines, containers, startup and deployment failures

Identity & secrets

Microsoft Entra ID, managed identity, RBAC, Key Vault and access troubleshooting

Networking

DNS, private endpoints, Application Gateway, load balancing, TLS and connectivity

Data services

Azure SQL connectivity, performance, backup, restore and availability

Automation

PowerShell, Azure CLI, repeatable operations and validation steps

Infrastructure code

Bicep, ARM and Terraform explanation, review and deployment guidance

Verify critical guidance

Cloud environments differ by region, service tier, policy, API version, network architecture, and organizational controls. For production or security-sensitive actions, validate guidance against Microsoft documentation and the actual resource state.

Recommended verification loop

Inspect → compare → test → change → observe → document

Use peer review and change controls required by your organization. Keep an audit trail of evidence, actions, and outcomes.