Skip to content

feat: add Apache SkyWalking monitoring provider#5533

Open
nexicturbo wants to merge 1 commit intokeephq:mainfrom
nexicturbo:feat/skywalking-provider
Open

feat: add Apache SkyWalking monitoring provider#5533
nexicturbo wants to merge 1 commit intokeephq:mainfrom
nexicturbo:feat/skywalking-provider

Conversation

@nexicturbo
Copy link

Summary

Adds a new provider for Apache SkyWalking APM system.

What is Apache SkyWalking?

Apache SkyWalking is an open-source Application Performance Monitoring (APM) system that provides distributed tracing, service mesh telemetry analysis, metric aggregation, and alerting.

Features

  • Pull-based alerts: Fetches alerts from SkyWalking OAP server via GraphQL API (getAlarm query)
  • Webhook support: Receives push alerts from SkyWalking alarm webhooks
  • Scope mapping: Maps SkyWalking scopes (Service, ServiceInstance, Endpoint, Process, etc.) to Keep alert sources
  • Health validation: Uses checkHealth GraphQL query to validate connection
  • Optional authentication: Supports basic auth for secured OAP servers

SkyWalking Alert Fields Mapped

  • id → Alert ID

ame → Alert name (entity name)

  • message → Alert message/description
  • scope → Alert scope (Service, Endpoint, etc.)
  • startTime → Alert start time

ecoveryTime → Used to determine RESOLVED vs FIRING status

  • ags → Preserved as alert tags (including severity if set)

Testing

The provider can be tested against a local SkyWalking OAP server:
\\�ash
export SKYWALKING_HOST=http://localhost:12800
python keep/providers/skywalking_provider/skywalking_provider.py
\\

References

/claim #5487

- Implements pull-based alert fetching via SkyWalking GraphQL API
- Supports webhook push alerts from SkyWalking alarm rules
- Maps SkyWalking scopes (Service, Endpoint, Instance, etc.) to Keep
- Includes health check validation
- Supports optional basic authentication

Closes keephq#5487
@vercel
Copy link

vercel bot commented Jan 29, 2026

@nexicturbo is attempting to deploy a commit to the KeepHQ Team on Vercel.

A member of the Team first needs to authorize it.

@dosubot dosubot bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Jan 29, 2026
@github-actions
Copy link
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

@greptile-apps
Copy link
Contributor

greptile-apps bot commented Jan 29, 2026

Target branch is not in the allowed branches list.

@dosubot dosubot bot added the Feature A new feature label Jan 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🙋 Bounty claim Feature A new feature size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant