Skip to content

feat: add Freshping uptime monitoring provider#6340

Open
selenaalpha77-sketch wants to merge 1 commit intokeephq:mainfrom
selenaalpha77-sketch:feat/freshping-provider
Open

feat: add Freshping uptime monitoring provider#6340
selenaalpha77-sketch wants to merge 1 commit intokeephq:mainfrom
selenaalpha77-sketch:feat/freshping-provider

Conversation

@selenaalpha77-sketch
Copy link
Copy Markdown

Summary

Adds a new provider for Freshping by Freshworks, a website and API uptime monitoring service. Freshping checks availability from multiple global locations and alerts teams when checks go down or recover.

  • Webhook-based provider: receives real-time alerts when Freshping checks become unavailable or recover
  • Map Freshping check_status values (unavailable, available, unknown) to Keep severities and alert statuses
  • Optional webhook secret token support for payload signature validation
  • Full alerts_mock.py for webhook payload testing
  • MDX documentation with step-by-step setup for configuring webhook alert contacts in Freshping

Note: Freshping does not expose a public REST API for polling check status, so this provider operates exclusively via webhooks. validate_scopes always returns true since there is no API endpoint to validate against.

Provider files

  • keep/providers/freshping_provider/freshping_provider.py
  • keep/providers/freshping_provider/__init__.py
  • keep/providers/freshping_provider/alerts_mock.py
  • docs/providers/documentation/freshping-provider.mdx

Test plan

  • Send a test webhook payload matching alerts_mock.py and verify _format_alert produces a correct AlertDto
  • Verify check_status: "unavailable" maps to FIRING / CRITICAL
  • Verify check_status: "available" maps to RESOLVED / INFO
  • Verify check_status: "unknown" maps to FIRING / WARNING

🤖 Generated with Claude Code

Adds a new provider for Freshping (by Freshworks), a website and API
uptime monitoring service.

- Webhook-based provider: receives real-time alerts when checks go down or recover
- Maps Freshping check statuses to Keep severities and alert statuses
- Full alerts_mock.py for webhook testing
- MDX documentation with step-by-step webhook setup instructions
@dosubot dosubot Bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Apr 26, 2026
@CLAassistant
Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.


evan seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

@github-actions
Copy link
Copy Markdown
Contributor

No linked issues found. Please add the corresponding issues in the pull request description.
Use GitHub automation to close the issue when a PR is merged

@dosubot dosubot Bot added Documentation Improvements or additions to documentation Feature A new feature Provider Providers related issues labels Apr 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Improvements or additions to documentation Feature A new feature Provider Providers related issues size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants