pager_tree-integrations 1.1.6 → 1.1.7

data/app/models/pager_tree/integrations/custom_webhook/v3_examples/sns_cloudwatch.yaml

@@ -0,0 +1,48 @@
+---
+preprocess:
+  - type: parse_sns
+rules:
+  - match:
+      log.data.Type: "Notification"
+      log.data.Message.NewStateValue: "ALARM"
+    actions:
+      - type: create
+        title: "{{sanitize log.data.Subject}}"
+        description: "{{log.data.Message.NewStateReason}}"
+        thirdparty_id: "{{log.data.Message.AlarmArn}}"
+        additional_data:
+          - format: text
+            label: Event Category
+            value: "scheduledChange"
+          - format: text
+            label: Affected Resources
+            value: "example-service|example-backend"
+          - format: link
+            label: Fargate Platform Docs
+            value: "https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform-fargate.html"
+          - format: link
+            label: Task Maintenance Docs
+            value: "https://docs.aws.amazon.com/AmazonECS/latest/userguide/task-maintenance.html"
+          - format: link
+            label: Service Definition Params
+            value: "https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service_definition_parameters.html#sd-deploymentconfiguration"
+          - format: link
+            label: Fargate Notifications Blog
+            value: "https://aws.amazon.com/blogs/containers/improving-operational-visibility-with-aws-fargate-task-retirement-notifications/"
+          - format: link
+            label: Create Deployment CLI
+            value: "https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html"
+          - format: link
+            label: AWS Support
+            value: "https://aws.amazon.com/support"
+
+  - match:
+      log.data.Type: "Notification"
+      log.data.Message.NewStateValue: "OK"
+    actions:
+      - type: resolve
+        thirdparty_id: "{{log.data.Message.AlarmArn}}"
+default:
+  actions:
+    - type: ignore
+      reason: "Unhandled AWS Health Event"

data/app/models/pager_tree/integrations/custom_webhook/v3_examples/sns_health_event.json

@@ -0,0 +1,21 @@
+{
+  "client": null,
+  "client_url": null,
+  "contexts": null,
+  "description": "example-service|example-backend\r\nDescription - You are receiving this notification because AWS Fargate has deployed a new platform version revision (1) and will retire any tasks running on previous platform version revision(s) starting at Wed, 12 Nov 2025 03:00 GMT as part of routine task maintenance (2). Please find the list of affected tasks in the \\\"Affected Resources\\\" tab . There is no action required on your part unless you want to replace these tasks before task maintenance start time. When using the default value of 100% for minimum healthy percent configuration of an Amazon Elastic Container Service (Amazon ECS) service (3), a replacement task will be launched on the most recent platform version revision before the affected task is retired. Any tasks launched after Wed, 5 Nov 2025 03:00 GMT were launched on the new platform version revision.\n\nAWS Fargate is a serverless, pay-as-you-go compute engine that lets you focus on building applications without managing servers. As described in ",
+  "event_type": "trigger",
+  "incident_key": "example-service|example-backend\r\nDescription - You are receiving this notification because AWS Fargate has deployed a new platform version revision (1) and will retire any tasks running on previous platform version revision(s) starting at Wed",
+  "service_key": "generic-service-key",
+  "details": {
+    "Message": "Account-generic-; Region - us-east-1\r\nEventCategory - scheduledChange\r\nAffected resources - example-service|example-backend\r\nDescription - You are receiving this notification because AWS Fargate has deployed a new platform version revision (1) and will retire any tasks running on previous platform version revision(s) starting at Wed, 12 Nov 2025 03:00 GMT as part of routine task maintenance (2). Please find the list of affected tasks in the \\\"Affected Resources\\\" tab . There is no action required on your part unless you want to replace these tasks before task maintenance start time. When using the default value of 100% for minimum healthy percent configuration of an Amazon Elastic Container Service (Amazon ECS) service (3), a replacement task will be launched on the most recent platform version revision before the affected task is retired. Any tasks launched after Wed, 5 Nov 2025 03:00 GMT were launched on the new platform version revision.\n\nAWS Fargate is a serverless, pay-as-you-go compute engine that lets you focus on building applications without managing servers. As described in the Fargate documentation (2) and (4), Fargate regularly deploys platform version revisions to make new features available and for routine maintenance. The Fargate update includes updates to the underlying Operating System (Linux or Windows as applicable), and to runtime components. Fargate will gradually replace the tasks in your service using your configured deployment settings, ensuring all tasks run on the new Fargate platform version revision.\n\nWe do not expect this update to impact your ECS services. However, if you want to control when your tasks are replaced, you can initiate an ECS service update before Wed, 12 Nov 2025 03:00 GMT  by following the instructions below. \n\nIf you are using the rolling deployment type for your service, you can run the update-service command from the AWS command-line interface specifying force-new-deployment:\n\n$ aws ecs update-service --service service_name \\\n--cluster cluster_name --force-new-deployment\n\nIf you are using the Blue/Green deployment type, please refer to the documentation for create-deployment (5) and create a new deployment using the same task definition version.\n\nPlease contact AWS Support (6) if you have any questions or concerns.\n\n(1) https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform-fargate.html\n(2) https://docs.aws.amazon.com/AmazonECS/latest/userguide/task-maintenance.html\n(3) https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service_definition_parameters.html#sd-deploymentconfiguration \n(4) https://aws.amazon.com/blogs/containers/improving-operational-visibility-with-aws-fargate-task-retirement-notifications/\n(5) https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html\n(6) https://aws.amazon.com/support\n\n",
+    "MessageId": "generic-message-id",
+    "Signature": "generic-signature",
+    "SignatureVersion": "1",
+    "SigningCertURL": "https://sns.us-east-1.amazonaws.com/SimpleNotificationService-generic.pem",
+    "Subject": "aws-health-scheduled change",
+    "Timestamp": "2025-11-19T03:17:38.633Z",
+    "TopicArn": "arn:aws:sns:us-east-1:generic-account:generic-health-topic",
+    "Type": "Notification",
+    "UnsubscribeURL": "https://sns.us-east-1.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-1:generic-account:generic-health-topic:generic-sub-arn"
+  }
+}

data/app/models/pager_tree/integrations/custom_webhook/v3_examples/sns_health_event.yaml

@@ -0,0 +1,43 @@
+---
+preprocess:
+  - type: parse_sns
+rules:
+  - match:
+      log.data.details.Type: "Notification"
+      log.data.details.TopicArn: { $regex: "^arn:aws:sns" }
+      log.data.details.Subject: "aws-health-scheduled change"
+    actions:
+      - type: create
+        title: "{{log.data.details.Subject}}"
+        description: "{{log.data.details.Message}}"
+        thirdparty_id: "{{log.data.details.MessageId}}"
+        additional_data:
+          - format: text
+            label: Event Category
+            value: "scheduledChange"
+          - format: text
+            label: Affected Resources
+            value: "example-service|example-backend"
+          - format: link
+            label: Fargate Platform Docs
+            value: "https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform-fargate.html"
+          - format: link
+            label: Task Maintenance Docs
+            value: "https://docs.aws.amazon.com/AmazonECS/latest/userguide/task-maintenance.html"
+          - format: link
+            label: Service Definition Params
+            value: "https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service_definition_parameters.html#sd-deploymentconfiguration"
+          - format: link
+            label: Fargate Notifications Blog
+            value: "https://aws.amazon.com/blogs/containers/improving-operational-visibility-with-aws-fargate-task-retirement-notifications/"
+          - format: link
+            label: Create Deployment CLI
+            value: "https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html"
+          - format: link
+            label: AWS Support
+            value: "https://aws.amazon.com/support"
+
+default:
+  actions:
+    - type: ignore
+      reason: "Unhandled AWS Health Event"

data/app/models/pager_tree/integrations/custom_webhook/v3_examples/sns_lambda_monitor.json

@@ -0,0 +1,31 @@
+{
+  "client": null,
+  "client_url": null,
+  "contexts": null,
+  "description": "LAMBDA FUNCTIONS WITH RECENT ERRORS:\n\n• example-lambda-function (us-east-1)\n  Last execution: 2025-11-13\n  Errors (last 7 runs): 3\n  Most recent error: 2025-11-13\n\nDashboard: https://example.com/dashboard\nGenerated: 2025-11-14 08:07 UTC",
+  "event_type": "trigger",
+  "incident_key": "generic-incident-key",
+  "service_key": "generic-service-key",
+  "details": {
+    "Message": "LAMBDA FUNCTIONS WITH RECENT ERRORS:\n\n• example-lambda-function (us-east-1)\n  Last execution: 2025-11-13\n  Errors (last 7 runs): 3\n  Most recent error: 2025-11-13\n\nDashboard: https://example.com/dashboard\nGenerated: 2025-11-14 08:07 UTC",
+    "MessageAttributes": {
+      "severity": {
+        "Type": "String",
+        "Value": "error"
+      },
+      "source": {
+        "Type": "String",
+        "Value": "lambda-monitoring"
+      }
+    },
+    "MessageId": "generic-message-id",
+    "Signature": "generic-signature",
+    "SignatureVersion": "1",
+    "SigningCertURL": "https://sns.us-east-1.amazonaws.com/SimpleNotificationService-generic.pem",
+    "Subject": "AWS Lambda Functions Failing: 1 function with recent errors detected",
+    "Timestamp": "2025-11-14T08:07:35.435Z",
+    "TopicArn": "arn:aws:sns:us-east-1:generic-account:sns-generic-topic",
+    "Type": "Notification",
+    "UnsubscribeURL": "https://sns.us-east-1.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-1:generic-account:sns-generic-topic:generic-sub-arn"
+  }
+}

data/app/models/pager_tree/integrations/custom_webhook/v3_examples/sns_lambda_monitor.yaml

@@ -0,0 +1,24 @@
+---
+preprocess:
+  - type: parse_sns
+rules:
+  - match:
+      log.data.details.MessageAttributes.severity.Value: "error"
+      log.data.details.MessageAttributes.source.Value: "lambda-monitoring"
+    actions:
+      - type: create
+        title: "{{log.data.details.Subject}}"
+        description: "{{log.data.details.Message}}"
+        thirdparty_id: "{{log.data.details.MessageId}}"
+        additional_data:
+          - format: link
+            label: Dashboard
+            value: "https://example.com/dashboard"
+          - format: text
+            label: Generated
+            value: "2025-11-14 08:07 UTC"
+
+default:
+  actions:
+    - type: ignore
+      reason: "Unhandled SNS notification type"

data/app/models/pager_tree/integrations/datadog/v3.rb

@@ -1,9 +1,12 @@
 module PagerTree::Integrations
   class Datadog::V3 < Integration
-    OPTIONS = []
+    OPTIONS = [
+      {key: :support_retriggered_event, type: :boolean, default: false}
+    ]
     store_accessor :options, *OPTIONS.map { |x| x[:key] }.map(&:to_s), prefix: "option"
 
     after_initialize do
+      self.option_support_retriggered_event ||= false
     end
 
     def adapter_supports_incoming?
@@ -24,8 +27,12 @@ module PagerTree::Integrations
 
     def adapter_action
       case _transition
-      when "Triggered" then :create
-      when "Recovered" then :resolve
+      when "Triggered"
+        :create
+      when "Recovered"
+        :resolve
+      when "Re-Triggered"
+        (option_support_retriggered_event == true) ? :recreate : :other
       else
         :other
       end

data/app/models/pager_tree/integrations/dynatrace/v3.rb

@@ -0,0 +1,67 @@
+module PagerTree::Integrations
+  class Dynatrace::V3 < Integration
+    OPTIONS = []
+    store_accessor :options, *OPTIONS.map { |x| x[:key] }.map(&:to_s), prefix: "option"
+
+    after_initialize do
+    end
+
+    def adapter_supports_incoming?
+      true
+    end
+
+    def adapter_supports_outgoing?
+      false
+    end
+
+    def adapter_incoming_can_defer?
+      true
+    end
+
+    def adapter_thirdparty_id
+      adapter_incoming_request_params.dig("ProblemID")
+    end
+
+    def adapter_action
+      state = adapter_incoming_request_params.dig("State")
+      return :create if state == "OPEN"
+      return :resolve if state == "RESOLVED"
+      :other
+    end
+
+    def adapter_process_create
+      Alert.new(
+        title: _title,
+        description: _description,
+        thirdparty_id: adapter_thirdparty_id,
+        dedup_keys: [],
+        additional_data: _additional_datums,
+        tags: _tags
+      )
+    end
+
+    private
+
+    def _title
+      adapter_incoming_request_params.dig("ProblemTitle")
+    end
+
+    def _description
+      adapter_incoming_request_params.dig("ProblemDetailsHTML").presence ||
+        adapter_incoming_request_params.dig("ProblemDetailsText").presence
+    end
+
+    def _tags
+      (adapter_incoming_request_params.dig("Tags") || "").split(",").map(&:strip).uniq.compact
+    end
+
+    def _additional_datums
+      [
+        AdditionalDatum.new(format: "link", label: "URL", value: adapter_incoming_request_params.dig("ProblemURL")),
+        AdditionalDatum.new(format: "text", label: "Impacted Entity", value: adapter_incoming_request_params.dig("ImpactedEntity")),
+        AdditionalDatum.new(format: "text", label: "Problem Impact", value: adapter_incoming_request_params.dig("ProblemImpact")),
+        AdditionalDatum.new(format: "text", label: "Problem Severity", value: adapter_incoming_request_params.dig("ProblemSeverity"))
+      ]
+    end
+  end
+end

data/app/models/pager_tree/integrations/echoes_hq/v3.rb

@@ -0,0 +1,138 @@
+module PagerTree::Integrations
+  class EchoesHq::V3 < Integration
+    OPTIONS = [
+      {key: :api_key, type: :string, default: nil}
+    ]
+    store_accessor :options, *OPTIONS.map { |x| x[:key] }.map(&:to_s), prefix: "option"
+
+    validates :option_api_key, presence: true
+
+    after_initialize do
+      self.option_api_key ||= nil
+    end
+
+    def adapter_supports_incoming?
+      false
+    end
+
+    def adapter_supports_outgoing?
+      true
+    end
+
+    def adapter_show_outgoing_webhook_delivery?
+      false
+    end
+
+    def adapter_supports_title_template?
+      false
+    end
+
+    def adapter_supports_description_template?
+      false
+    end
+
+    def adapter_supports_auto_aggregate?
+      false
+    end
+
+    def adapter_supports_auto_resolve?
+      false
+    end
+
+    def adapter_outgoing_interest?(event_name)
+      ["alert_open", "alert_acknowledged", "alert_resolved"].include?(event_name.to_s)
+    end
+
+    def adapter_process_outgoing
+      @pager_tree_alert = adapter_outgoing_event.alert
+
+      create_or_update_echoes_hq_incident
+    end
+
+    private
+
+    def echoes_hq_incident_id
+      "PAGERTREE_#{@pager_tree_alert.tiny_id}"
+    end
+
+    def echoes_hq_status
+      case @pager_tree_alert.status.to_s
+      when "acknowledged" then "acknowledged"
+      when "resolved" then "resolved"
+      else
+        "triggered"
+      end
+    end
+
+    def echoes_hq_headers
+      {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        Authorization: "Bearer #{option_api_key}"
+      }
+    end
+
+    def get_echoes_hq_incident
+      url = "https://api.echoeshq.com/v1/signals/incidents/#{echoes_hq_incident_id}"
+      response = HTTParty.get(url, headers: echoes_hq_headers, timeout: 3)
+      (response.code == 200) ? response.parsed_response : nil
+    rescue
+      nil
+    ensure
+      logs.create(level: :info, format: :json, message: {
+        message: "GET EchoesHQ Incident for PagerTree alert ##{@pager_tree_alert.tiny_id}",
+        url: url,
+        response: response
+      })
+    end
+
+    def create_echoes_hq_incident
+      url = "https://api.echoeshq.com/v1/signals/incidents"
+      body = {
+        id: echoes_hq_incident_id,
+        title: @pager_tree_alert.title,
+        service: {
+          name: @pager_tree_alert.source&.name || name
+        },
+        started_at: @pager_tree_alert.created_at.iso8601
+      }
+
+      response = HTTParty.post(url, body: body.to_json, headers: echoes_hq_headers, timeout: 3)
+      (response.code == 200) ? response.parsed_response : nil
+    rescue
+      nil
+    ensure
+      logs.create(level: :info, format: :json, message: {
+        message: "CREATE EchoesHQ Incident for PagerTree alert ##{@pager_tree_alert.tiny_id}",
+        url: url,
+        body: body,
+        response: response
+      })
+    end
+
+    def update_echoes_hq_incident
+      url = "https://api.echoeshq.com/v1/signals/incidents/#{echoes_hq_incident_id}"
+      body = {
+        title: @pager_tree_alert.title,
+        status: echoes_hq_status,
+        resolved_at: @pager_tree_alert.resolved_at&.iso8601
+      }
+      response = HTTParty.put(url, body: body.to_json, headers: echoes_hq_headers, timeout: 3)
+      (response.code == 200) ? response.parsed_response : nil
+    rescue
+      nil
+    ensure
+      logs.create(level: :info, format: :json, message: {
+        message: "UPDATE EchoesHQ Incident for PagerTree alert ##{@pager_tree_alert.tiny_id}",
+        url: url,
+        body: body,
+        response: response
+      })
+    end
+
+    def create_or_update_echoes_hq_incident
+      create_echoes_hq_incident unless get_echoes_hq_incident.present?
+      update_echoes_hq_incident
+    end
+  end
+end

data/app/models/pager_tree/integrations/elast_alert/v3.rb

@@ -25,6 +25,7 @@ module PagerTree::Integrations
     def adapter_action
       case _event_type
       when "create" then :create
+      when "acknowledge" then :acknowledge
       when "resolve" then :resolve
       else
         :other
@@ -41,6 +42,29 @@ module PagerTree::Integrations
       )
     end
 
+    # elastalert will raise an error for any 4xx or 5xx response and then retry for a default of 2 days
+    # https://github.com/Yelp/elastalert/blob/master/elastalert/alerts.py#L1496
+    # we don't want to get spammy with retries, so we'll just return a 200
+    def adapter_response_rate_limit_code
+      :ok
+    end
+
+    def adapter_response_disabled_code
+      :ok
+    end
+
+    def adapter_response_inactive_subscription_code
+      :ok
+    end
+
+    def adapter_response_upgrade_code
+      :ok
+    end
+
+    def adapter_response_blocked_code
+      :ok
+    end
+
     private
 
     # See https://github.com/Yelp/elastalert/pull/2001 for details