Wolvenware
Documentation
Overview
ConfluOps embeds live AWS CloudWatch alarm statuses as color-coded badges directly in your Confluence pages. Place indicators anywhere on a page — in tables, dashboards, or inline with text — to give your team instant visibility into infrastructure health without leaving Confluence.
Prerequisites
- A Confluence Cloud instance with ConfluOps installed from the Atlassian Marketplace
- Confluence administrator access (to add AWS accounts)
- An AWS account with at least one CloudWatch alarm
- Permission to create an IAM role in that AWS account (or supply access keys)
Setup
1. Open the setup wizard
-
In Confluence, open Administration (, top right). In the left-hand menu, expand Apps and click ConfluOps. Click Add account to open the setup wizard.
-
Enter an account alias (e.g. Production or Staging), your AWS account ID, and the primary region where your CloudWatch alarms live. Select an authentication method and click Next.
2. Grant AWS access
IAM Role (recommended)
ConfluOps connects using an IAM role — no long-lived credentials are stored. The wizard provides a CloudFormation link and a Terraform snippet, both with your site’s External ID already embedded. Use whichever suits your workflow.
-
Copy the CloudFormation link or the Terraform snippet from the wizard.
-
CloudFormation: open the AWS Console, paste the link, and complete the stack creation. Wait until the stack reaches
CREATE_COMPLETE. Go to the stack’s Outputs tab and copy theRoleArnvalue.
Terraform: paste the snippet into your configuration, runterraform apply, and copy therole_arnoutput. -
Back in the wizard, click I’ve deployed this role and paste the role ARN.
IAM User (not recommended)
IAM User credentials are long-lived and stored persistently — use this only if role assumption is unavailable in your environment. Enter your Access Key ID and Secret Access Key when prompted.
3. Test and save
-
Click Next, then Test connection.
-
Once the connection is confirmed, click Done.
Adding a widget to a page
Select an alarm
-
On any Confluence page, open the macro browser (
/or Insert → Other macros) and search for CloudWatch Alarm Indicator. -
Select the AWS account you configured in the setup step.
-
A searchable list of alarms from that account will appear. Use the search box to filter by name, then click an alarm to select it.
Display options
After selecting an alarm you can customise how the badge appears:
| Option | Description |
|---|---|
| Display label | Text shown alongside the badge. Defaults to the alarm name; change it to something human-readable like API Error Rate. |
| Label position | Where the label appears relative to the badge: right, left, above, below, inside (replaces the state text), or hidden. |
| Alignment | How the badge is aligned within the macro block: left, center, or right. |
| Auto-refresh | How often the badge refreshes while a viewer has the page open. See Auto-refresh below. |
A live preview updates as you change options so you can see exactly how the badge will look before inserting it.
Alarm states
Each badge reflects the current CloudWatch alarm state:
| State | Badge | Meaning |
|---|---|---|
OK |
OK | The alarm threshold has not been breached. |
ALARM |
ALARM | The alarm threshold has been breached. |
INSUFFICIENT_DATA |
INSUFFICIENT DATA | Not enough data is available to evaluate the alarm. |
Auto-refresh
By default, the badge fetches the alarm state when the page loads and does not update again until the page is reloaded. You can enable automatic background refresh:
| Interval | Use case |
|---|---|
| Off (default) | Status checked on page load only |
| 1 minute | Active incident dashboards |
| 5 minutes | General health monitoring pages |
| 15 minutes | Low-traffic overview pages |
Multiple AWS accounts
ConfluOps supports multiple AWS accounts simultaneously. Each account is configured separately in the admin panel with its own IAM role and External ID. When adding a widget, you choose which account to query — so a single Confluence page can display alarm statuses from Production, Staging, and any other configured account side by side.
Troubleshooting
Badge shows “Account not found”
The AWS account configured for this widget has been deleted from the admin panel. Edit the macro and select a valid account, or re-add the account in the admin panel.
Badge shows “Error fetching alarm”
Possible causes:
- The IAM role ARN or External ID is incorrect — verify them in the admin panel against your CloudFormation stack outputs.
- The alarm name no longer exists in CloudWatch — it may have been renamed or deleted.
-
The IAM role does not have
cloudwatch:DescribeAlarmspermission — re-deploy the CloudFormation stack using the latest template.
No alarms appear in the alarm picker
- Confirm the correct AWS region is selected for the account in the admin panel.
- Verify that alarms exist in that region in the AWS Console.
- Check that the IAM role was successfully created (no errors during account setup).
Alarm list is taking a long time to load
ConfluOps fetches alarm lists live from CloudWatch. If you have a large number of alarms, use the search box to filter by name rather than scrolling through the full list.
Support
For help, questions, or bug reports, please contact: