Skip to content

docs(logs): Add alerts documentation#16697

Open
inkeep[bot] wants to merge 3 commits intomasterfrom
docs-writer-ai-update-2026-05-01T15-34-28-505Z-xyk2f4
Open

docs(logs): Add alerts documentation#16697
inkeep[bot] wants to merge 3 commits intomasterfrom
docs-writer-ai-update-2026-05-01T15-34-28-505Z-xyk2f4

Conversation

@inkeep
Copy link
Copy Markdown
Contributor

@inkeep inkeep Bot commented May 1, 2026

Changes

This PR adds new documentation for Logs Alerts, based on the feature changes introduced in PostHog/posthog#57271.

New files

  • contents/docs/logs/alerts.mdx - New documentation page for sending logs alerts

Updated files

  • src/navs/index.js - Added "Send alerts" navigation entry to the Logs sidebar

What's documented

The new alerts page covers:

  1. Overview - What logs alerts do (notify when log patterns exceed/drop below thresholds)
  2. Creating an alert - The new click-to-create flow where "New alert" creates a draft immediately
  3. Draft state concept - Explains that alerts start as drafts with a "Draft" badge and can be saved incomplete
  4. Configuring filters - Severity levels, service names, and attribute filters
  5. Threshold rules - Above/below operator, threshold count, time window options
  6. Notification destinations - Slack and webhook configuration
  7. Enabling the alert - Pre-enable validation checks (blocked if no filters, warning if no destinations)
  8. Managing alerts - Disable, snooze, reset, and delete actions

Related PR

This documents features from: PostHog/posthog#57271


This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

inkeep Bot added 3 commits May 1, 2026 15:37
Covers the new draft alert workflow introduced in PostHog/posthog#57271:
- Creating alerts via click-to-create flow
- Draft state concept
- Filter, threshold, and notification configuration
- Pre-enable checks (blocked/warning states)
- Alert management (disable, snooze, reset, delete)
@inkeep inkeep Bot requested a review from jonmcwest May 1, 2026 15:43
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview May 01, 2026 03:55PM

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

Vale prose linter → found 2 errors, 3 warnings, 0 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/logs/alerts.mdx — 2 errors, 3 warnings, 0 suggestions
Line Severity Message Rule
2:13 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
12:43 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
18:38 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
39:18 warning 'cooldown' is a possible misspelling. PostHogBase.Spelling
43:131 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

Hey @jonmcwest! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

  1. Review and approve the PR
  2. Merge the PR
    a. Check the preview env and CI build and merge it yourself
    b. Enable auto-merge if you're confident in the changes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant