Back to Setup Guide

Reference Guide

Status & Settings

Check your connected AWS accounts and configure detection settings at any time with the /sanecost status and /sanecost config commands.

Running the Status Command

Type this in any channel where SaneCost is installed to view your connected AWS accounts and their connection status:

/sanecost status

SaneCost replies with your connected AWS accounts and their connection status. To view or update current detection settings, use /sanecost config.

Understanding the Output

Here's what a healthy status response looks like:

# any-channel
SC

SaneCost APP just now

📊 SaneCost Connection Status

Connected Accounts: 1

Account ID270313871197
Tierread-only
Connected2026-03-27 14:32 UTC
Status✅ CREATE_COMPLETE

What Each Field Means

Status Fields

Account ID

Your 12-digit AWS account number. Matches the account where you deployed the CloudFormation stack.

Tier

The permission level of the connection. Typically read-only — SaneCost can read EC2 and CloudWatch data but can't modify resources.

Connected

The date and time the CloudFormation stack was created and the account was linked to your workspace.

Status

✅ CREATE_COMPLETE means the CloudFormation stack is healthy. Other statuses indicate a problem with the stack.

Viewing Settings (/sanecost config)

Run /sanecost config (without any arguments) to see your current detection settings. These control when and how SaneCost flags idle instances:

cpu-threshold

CPU percentage below which an instance is considered idle. Default: 5%

cpu-duration

How many hours of continuous low CPU before flagging. Default: 2 hours

min-savings

Minimum monthly savings to trigger an alert. Filters out tiny instances. Default: $5/month

channel

The Slack channel where waste alerts are posted. Set via /sanecost config channel #channel.

Changing a setting: Use /sanecost config <setting> <value>. For example, /sanecost config cpu-threshold 10 raises the idle CPU bar to 10%, or /sanecost config cpu-duration 0.5 sets it to 30 minutes.

Troubleshooting Common Issues

No connected accounts

Fix: Run /sanecost connect aws and complete the CloudFormation setup. The account appears automatically once the stack reaches CREATE_COMPLETE.

Status doesn't show CREATE_COMPLETE

Likely cause: The CloudFormation stack failed or the IAM cross-account role was modified. Open your AWS console, navigate to CloudFormation, and check the SaneCost-* stack events for errors. You may need to delete and re-create the stack.

Not receiving alerts in your channel

Fix: Make sure SaneCost is a member of the notification channel — go to the channel and run /invite @SaneCost. Also verify the channel is set with /sanecost config channel #your-channel.

Multiple AWS Accounts

SaneCost supports connecting multiple AWS accounts to a single Slack workspace. Run /sanecost connect aws again from a different AWS account to add it. The status command will list all connected accounts:

# any-channel
SC

SaneCost APP just now

Connected Accounts: 2

Account ID270313871197
Tierread-only
Status✅ CREATE_COMPLETE
Account ID116108555665
Tierread-only
Status✅ CREATE_COMPLETE

Tip: Each AWS account needs its own CloudFormation stack. Alerts from all accounts are posted to the same notification channel.