PyPI - detectkit - Versions diffs - 0.16.0__tar.gz → 0.16.1__tar.gz - Mend

@@ -293,20 +293,21 @@ class WebhookChannel(BaseAlertChannel):
             err = f"{ctx['error_type']}: {ctx['error_message']}".strip(": ")
             full("Error", code(err))
-        # Optional links block (dashboard_url is already the clickable title;
-        # surface bare URLs here too so they're visible/linkified on both).
-        link_lines = []
+        # Links block — kept as its own flexible field, but every entry is a
+        # compact clickable label, never a raw URL string. A Grafana dashboard
+        # URL can be a paragraph long once it carries variables; nobody should
+        # read that in an alert, so we hide it behind the label and render in the
+        # platform's link syntax. Holds dashboard + any extra links + the "how to
+        # read this alert" guide, joined by " · ".
+        link_parts = []
         if alert_data.dashboard_url:
-            link_lines.append(f"Dashboard: {alert_data.dashboard_url}")
+            link_parts.append(self._link_markup(alert_data.dashboard_url, "Dashboard"))
         for label, url in alert_data.links.items():
-            link_lines.append(f"{label}: {url}")
-        if link_lines:
-            full("Links", "\n".join(link_lines))
-        # "How to read this alert" — the last field, a bare URL (auto-linkified on
-        # both Slack and Mattermost) pointing readers at the interpretation guide.
+            link_parts.append(self._link_markup(url, label))
         if ctx["help_url"]:
-            full(ctx["help_label"], ctx["help_url"])
+            link_parts.append(self._link_markup(ctx["help_url"], ctx["help_label"]))
+        if link_parts:
+            full("Links", " · ".join(link_parts))
         # A plain-text one-liner for notification previews / unsupported clients.
         if kind == "no_data":
@@ -328,6 +329,19 @@ class WebhookChannel(BaseAlertChannel):
             "mrkdwn_in": ["text", "fields"],
         }
+    def _link_markup(self, url: str, label: str) -> str:
+        """Render *label* as a clickable link in the target platform's syntax.
+        Slack incoming webhooks (``hooks.slack.com``) use ``<url|label>``;
+        Mattermost and other webhooks use markdown ``[label](url)``. This keeps a
+        link a short clickable phrase instead of a raw URL — important because a
+        real dashboard URL (e.g. Grafana with many variables) can be extremely
+        long, and no one should have to read it inside an alert.
+        """
+        if "hooks.slack.com" in self.webhook_url:
+            return f"<{url}|{label}>"
+        return f"[{label}]({url})"
     @staticmethod
     def _unix_ts(ts: Any) -> int | None:
         """Epoch seconds (UTC) for a naive-UTC timestamp, or None on failure."""

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: detectkit
-Version: 0.16.0
+Version: 0.16.1
 Summary: Metric monitoring with automatic anomaly detection
 Author: detectkit team
 License: MIT

@@ -4,7 +4,7 @@ detectk - Anomaly Detection for Time-Series Metrics
 A Python library for data analysts and engineers to monitor metrics with automatic anomaly detection.
 """
-__version__ = "0.16.0"
+__version__ = "0.16.1"
 from detectkit.core.interval import Interval
 from detectkit.core.models import ColumnDefinition, TableModel

@@ -167,9 +167,11 @@ config needed. Control it project-wide with `alert_help_url` in
 Per-channel rendering (defaults only; resolved by
 `ProjectConfig.resolve_alert_help_url`):
-- **Slack / Mattermost / generic webhook** — a bottom full-width attachment field
-  titled `How to read this alert` whose value is the bare URL (auto-linkified on
-  both platforms).
+- **Slack / Mattermost / generic webhook** — a clickable `How to read this alert`
+  label in the compact `Links` field (alongside `Dashboard` + any extra links),
+  never a raw URL. Rendered in the platform's link syntax (Slack `<url|label>`,
+  Mattermost/generic markdown links) so a long dashboard URL stays hidden behind
+  its label.
 - **Telegram** — appended to the links line (after the optional "Open dashboard"
   link) as an `<a>` link reading `How to read this alert`.
 - **Email** — in the footer, after `Sent by detectkit · <project>` (and any CC),

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: detectkit
-Version: 0.16.0
+Version: 0.16.1
 Summary: Metric monitoring with automatic anomaly detection
 Author: detectkit team
 License: MIT

detectkit 0.16.0__tar.gz → 0.16.1__tar.gz

detectkit 0.16.0tar.gz → 0.16.1tar.gz