From bc02208b3d7e2f8488f9fddb2fa7ba82719cbb4c Mon Sep 17 00:00:00 2001
From: Matt Kufchak <matt@knock.app>
Date: Thu, 6 Nov 2025 12:34:50 -0600
Subject: [PATCH] chore: add provider and workflow_category metrics tags to
 datadog and new relic

---
 content/integrations/extensions/datadog.mdx   | 16 ++++++++++------
 content/integrations/extensions/new-relic.mdx | 14 +++++++++-----
 2 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/content/integrations/extensions/datadog.mdx b/content/integrations/extensions/datadog.mdx
index 8803ff3b7..fb8e87484 100644
--- a/content/integrations/extensions/datadog.mdx
+++ b/content/integrations/extensions/datadog.mdx
@@ -30,8 +30,10 @@ This integration will send a stream of metrics as they happen from your Knock ac
 
 - Environment
 - Workflow key
+- Workflow category
 - Workflow exec mode
 - Channel or workflow step type
+- Channel provider
 - Integration source type
 - Error reason
 
@@ -39,6 +41,8 @@ Please refer to your Datadog pricing agreement for information on how custom met
 
 At this time there is no way to selectively enable specific metrics, however metrics will only be emitted to Datadog for features that you are actively using in Knock.
 
+A workflow can have one or more [categories](/concepts/workflows#workflow-categories). For applicable metrics, each category will have a unique tag on the emitted metrics; a workflow with categories `transcational` and `updates` will have the tags `workflow_category:transcational` and `workflow_category:updates`.
+
 ## Installing the integration
 
 1. Visit the **Extensions** page under the **Integrations** section of your Knock dashboard account settings
@@ -78,32 +82,32 @@ Get started with our Datadog dashboard starter kit to start monitoring Knock met
   <Attribute
     name="knock.message_delivered.total"
     type="count"
-    description="How many messages have been delivered, segmented by `channel` and `workflow` key."
+    description="How many messages have been delivered, segmented by `channel`, `provider`, `workflow` key, and `workflow_category`."
   />
   <Attribute
     name="knock.message_delivered_retryable_error.total"
     type="count"
-    description="How many deliveries ended in a retryable failure, segmented by `channel` and `workflow` key."
+    description="How many deliveries ended in a retryable failure, segmented by `channel`, `provider`, `workflow` key, and `workflow_category`."
   />
   <Attribute
     name="knock.message_delivered_error.total"
     type="count"
-    description="How many deliveries ended in failure (not retryable), segmented by `channel` and `workflow` key."
+    description="How many deliveries ended in failure (not retryable), segmented by `channel`, `provider`, `workflow` key, and `workflow_category`."
   />
   <Attribute
     name="knock.message_bounced_error.total"
     type="count"
-    description="How many deliveries ended in non-retryable errors from downstream providers, segmented by `channel` and `workflow` key."
+    description="How many deliveries ended in non-retryable errors from downstream providers, segmented by `channel`, `provider`, `workflow` key, and `workflow_category`."
   />
   <Attribute
     name="knock.workflow_recipient_run.total"
     type="count"
-    description="How many workflow recipient runs have been started, segmented by `workflow` key and `exec_mode`."
+    description="How many workflow recipient runs have been started, segmented by `workflow` key, `exec_mode`, and `workflow_category`."
   />
   <Attribute
     name="knock.workflow_recipient_run_error.total"
     type="count"
-    description="How many errors were experienced during a workflow recipient run, segmented by `workflow` key, `exec_mode`, `step_type`, and the error `reason`. A workflow recipient run can report more than one error."
+    description="How many errors were experienced during a workflow recipient run, segmented by `workflow` key, `exec_mode`, `step_type`, `workflow_category`, and the error `reason`. A workflow recipient run can report more than one error."
   />
   <Attribute
     name="knock.integration_event_received.total"
diff --git a/content/integrations/extensions/new-relic.mdx b/content/integrations/extensions/new-relic.mdx
index 42a147ce9..f856496fb 100644
--- a/content/integrations/extensions/new-relic.mdx
+++ b/content/integrations/extensions/new-relic.mdx
@@ -30,8 +30,10 @@ This integration will stream metrics from your Knock account to your New Relic a
 
 - Environment
 - Workflow key
+- Workflow category
 - Workflow exec mode
 - Channel or workflow step type
+- Channel provider
 - Integration source type
 - Error reason
 
@@ -39,6 +41,8 @@ Please refer to your New Relic pricing agreement for information on how custom m
 
 At this time there is no way to selectively enable specific metrics, but metrics will only be emitted to New Relic for features that you are actively using in Knock.
 
+A workflow can have one or more [categories](/concepts/workflows#workflow-categories). For applicable metrics, each category will have a unique tag on the emitted metrics; a workflow with categories `transcational` and `updates` will have the tags `workflow_category:transcational` and `workflow_category:updates`.
+
 ## Installing the integration
 
 1. Visit the **Extensions** page under the **Integrations** section of your Knock dashboard account settings
@@ -84,27 +88,27 @@ Get started with our New Relic dashboard starter kit to start monitoring Knock m
   <Attribute
     name="knock.message_delivered.total"
     type="count"
-    description="How many messages have been delivered, segmented by `channel` and `workflow` key."
+    description="How many messages have been delivered, segmented by `channel`, `provider`, `workflow` key, and `workflow_category`."
   />
   <Attribute
     name="knock.message_delivered_retryable_error.total"
     type="count"
-    description="How many deliveries ended in a retryable failure, segmented by `channel` and `workflow` key."
+    description="How many deliveries ended in a retryable failure, segmented by `channel`, `provider`, `workflow` key, and `workflow_category`."
   />
   <Attribute
     name="knock.message_delivered_error.total"
     type="count"
-    description="How many deliveries ended in failure (not retryable), segmented by `channel` and `workflow` key."
+    description="How many deliveries ended in failure (not retryable), segmented by `channel`, `provider`, `workflow` key, and `workflow_category`."
   />
   <Attribute
     name="knock.workflow_recipient_run.total"
     type="count"
-    description="How many workflow recipient runs have been started, segmented by `workflow` key and `exec_mode`."
+    description="How many workflow recipient runs have been started, segmented by `workflow` key, `exec_mode`, and `workflow_category`."
   />
   <Attribute
     name="knock.workflow_recipient_run_error.total"
     type="count"
-    description="How many errors were experienced during a workflow recipient run, segmented by `workflow` key, `exec_mode`, `step_type`, and the error `reason`. A workflow recipient run can report more than one error."
+    description="How many errors were experienced during a workflow recipient run, segmented by `workflow` key, `exec_mode`, `step_type`, `workflow_category`, and the error `reason`. A workflow recipient run can report more than one error."
   />
   <Attribute
     name="knock.integration_event_received.total"