Kener Docs
llms.txt
Search Documentation
Search through all documentation pages
Core Concepts

Sharing Monitors

Configure badge and embed sharing, including site-level and monitor-level controls

Kener supports sharing monitor data through badges and embeds, plus a live events embed.

What you can share

Badges

From Manage → Badges, you can generate:

  • Status badge
  • Uptime badge
  • Latency badge (average, maximum, minimum)
  • Dot badges

You can customize style, label, colors, and time range.

Embeds

From Manage → Embed, you can generate:

  • Status Bar embed for a monitor
  • Latency Chart embed for a monitor
  • Live Events embed (incidents + maintenances)

You can copy output as iframe or script.

Live Events widget

Live Events embed supports:

  • incidents on/off
  • maintenances on/off
  • optional monitor tag filtering

This lets you show one combined events feed or a scoped feed for selected monitors.

Where controls are configured

Site-level controls

In Manage → Site Configurations → Monitor Sub Menu Options:

  • showShareBadgeMonitor
  • showShareEmbedMonitor

These are global toggles for monitor sharing actions.

Monitor-level controls

In Manage → Monitors → [monitor] → Sharing Options:

  • showShareBadgeMonitor
  • showShareEmbedMonitor

These are saved per monitor in monitor_settings_json.sharing_options.

Precedence rules (important)

Important

Site-level settings override monitor-level settings.

A sharing action is visible only when both are enabled:

  • site-level toggle is enabled
  • monitor-level toggle is enabled

If site-level is disabled, monitor-level cannot re-enable it.

How this appears on the public monitor page

On a monitor page, the share buttons in the top action bar are shown only when allowed by both levels:

  • Badges menu requires site + monitor badge permission.
  • Embed menu requires site + monitor embed permission.
  1. Enable global sharing defaults in Site Configurations.
  2. For sensitive monitors, disable badge/embed in monitor Sharing Options.
  3. Use Manage → Badges and Manage → Embed to generate final snippets.
  4. Verify visibility from a public monitor page.