saba-webhook-gateway 1.1.0

data/lib/saba-webhook-gateway/base.rb

@@ -0,0 +1,359 @@
+# Saba Webhook Gateway base
+# Copyright 2023 Kenshi Muto <kmuto@kmuto.jp>
+require 'json'
+
+# main namespace for Saba Webhook Gateway
+module SabaWebhookGateway
+  class Base
+    # Initialize a new SabaWebhookGateway object.
+    #
+    # @return [SabaWebhookGateway::Base]
+    def initialize
+      @debug = ENV['DEBUG'] || nil
+    end
+
+    # Convert epoch to 'MM/DD hh:mm'.
+    #
+    # @param [Integer] :epoch Time epoch.
+    # @return [String]
+    def to_date(epoch)
+      Time.at(epoch.to_i).strftime('%m/%d %H:%M')
+    end
+
+    # Convert JSON to Ruby Hash.
+    #
+    # @param [String] :json JSON content.
+    # @return [Hash]
+    def parse(json)
+      begin
+        JSON.parse(json, symbolize_names: true)
+      rescue JSON::ParserError => e
+        if @debug
+          puts "[json error]\n#{e}"
+        end
+        nil
+      end
+    end
+
+    # Process sample notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def sample(h)
+      puts "[sample]\n#{h}"
+      '{ "event": "sample" }'
+    end
+
+    # Process alert notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def alert(h)
+      puts "[alert]\n#{h}"
+      '{ "event": "alert" }'
+    end
+
+    # Process alert group notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def alert_group(h)
+      puts "[alert_group]\n#{h}"
+      '{ "event": "alertGroup" }'
+    end
+
+    # Process host registration notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def host_register(h)
+      puts "[host_register]\n#{h}"
+      '{ "event": "hostRegister" }'
+    end
+
+    # Process host status change notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def host_status(h)
+      puts "[host_status]\n#{h}"
+      '{ "event": "hostStatus" }'
+    end
+
+    # Process host retirement notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def host_retire(h)
+      puts "[host_retire]\n#{h}"
+      '{ "event": "hostRetire" }'
+    end
+
+    # Process monitor creation notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_create(h)
+      case h[:monitor][:type]
+      when 'host'
+        monitor_create_host(h)
+      when 'external'
+        monitor_create_external(h)
+      when 'expression'
+        monitor_create_expression(h)
+      when 'anomalyDetection'
+        monitor_create_anomaly_detection(h)
+      when 'service'
+        monitor_create_service(h)
+      when 'connectivity'
+        monitor_create_connectivity(h)
+      end
+    end
+
+    # Process monitor creation (host) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_create_host(h)
+      puts "[monitor_create_host]\n#{h}"
+      '{ "event": "monitorCreate/host" }'
+    end
+
+    # Process monitor creation (external) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_create_external(h)
+      puts "[monitor_create_external]\n#{h}"
+      '{ "event": "monitorCreate/external" }'
+    end
+
+    # Process monitor creation (expression) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_create_expression(h)
+      puts "[monitor_create_expression]\n#{h}"
+      '{ "event": "monitorCreate/expression" }'
+    end
+
+    # Process monitor creation (anomaly detection) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_create_anomaly_detection(h)
+      puts "[monitor_create_anomaly_detection]\n#{h}"
+      '{ "event": "monitorCreate/anomalyDetection" }'
+    end
+
+    # Process monitor creation (service) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_create_service(h)
+      puts "[monitor_create_service]\n#{h}"
+      '{ "event": "monitorCreate/service" }'
+    end
+
+    # Process monitor creation (connectivity) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_create_connectivity(h)
+      puts "[monitor_create_connectivity]\n#{h}"
+      '{ "event": "monitorCreate/connectivity" }'
+    end
+
+    # Process monitor update notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_update(h)
+      case h[:monitor][:type]
+      when 'host'
+        monitor_update_host(h)
+      when 'external'
+        monitor_update_external(h)
+      when 'expression'
+        monitor_update_expression(h)
+      when 'anomalyDetection'
+        monitor_update_anomaly_detection(h)
+      when 'service'
+        monitor_update_service(h)
+      when 'connectivity'
+        monitor_update_connectivity(h)
+      end
+    end
+
+    # Process monitor update (host) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_update_host(h)
+      puts "[monitor_update_host]\n#{h}"
+      '{ "event": "monitorUpdate/host" }'
+    end
+
+    # Process monitor update (external) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_update_external(h)
+      puts "[monitor_update_external]\n#{h}"
+      '{ "event": "monitorUpdate/external" }'
+    end
+
+    # Process monitor update (expression) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_update_expression(h)
+      puts "[monitor_update_expression]\n#{h}"
+      '{ "event": "monitorUpdate/expression" }'
+    end
+
+    # Process monitor update (anomaly detection) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_update_anomaly_detection(h)
+      puts "[monitor_update_anomaly_detection]\n#{h}"
+      '{ "event": "monitorUpdate/anomalyDetection" }'
+    end
+
+    # Process monitor update (service) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_update_service(h)
+      puts "[monitor_update_service]\n#{h}"
+      '{ "event": "monitorUpdate/service" }'
+    end
+
+    # Process monitor update (connectivity) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_update_connectivity(h)
+      puts "[monitor_update_connectivity]\n#{h}"
+      '{ "event": "monitorUpdate/connectivity" }'
+    end
+
+    # Process monitor deletion notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_delete(h)
+      case h[:monitor][:type]
+      when 'host'
+        monitor_delete_host(h)
+      when 'external'
+        monitor_delete_external(h)
+      when 'expression'
+        monitor_delete_expression(h)
+      when 'anomalyDetection'
+        monitor_delete_anomaly_detection(h)
+      when 'service'
+        monitor_delete_service(h)
+      when 'connectivity'
+        monitor_delete_connectivity(h)
+      end
+    end
+
+    # Process monitor deletion (host) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_delete_host(h)
+      puts "[monitor_delete_host]\n#{h}"
+      '{ "event": "monitorDelete/host" }'
+    end
+
+    # Process monitor deletion (external) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_delete_external(h)
+      puts "[monitor_delete_external]\n#{h}"
+      '{ "event": "monitorDelete/external" }'
+    end
+
+    # Process monitor deletion (expression) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_delete_expression(h)
+      puts "[monitor_delete_expression]\n#{h}"
+      '{ "event": "monitorDelete/expression" }'
+    end
+
+    # Process monitor deletion (anomaly detection) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_delete_anomaly_detection(h)
+      puts "[monitor_delete_anomaly_detection]\n#{h}"
+      '{ "event": "monitorDelete/anomalyDetection" }'
+    end
+
+    # Process monitor deletion (service) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_delete_service(h)
+      puts "[monitor_delete_service]\n#{h}"
+      '{ "event": "monitorDelete/service" }'
+    end
+
+    # Process monitor deletion (connectivity) notifications.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def monitor_delete_connectivity(h)
+      puts "[monitor_delete_connectivity]\n#{h}"
+      '{ "event": "monitorDelete/connectivity" }'
+    end
+
+    # Call the respective notification method according to the event.
+    #
+    # @param [Hash] :h Event Hash object.
+    # @return [String]
+    def handle_by_event(h)
+      case h[:event]
+      when 'sample'
+        sample(h)
+      when 'alert'
+        alert(h)
+      when 'alertGroup'
+        alert_group(h)
+      when 'hostRegister'
+        host_register(h)
+      when 'hostStatus'
+        host_status(h)
+      when 'hostRetire'
+        host_retire(h)
+      when 'monitorCreate'
+        monitor_create(h)
+      when 'monitorUpdate'
+        monitor_update(h)
+      when 'monitorDelete'
+        monitor_delete(h)
+      end
+    end
+
+    # Post JSON to the target.
+    #
+    # @param [String] :json JSON content.
+    def post(json)
+      puts "[post]\n#{json}"
+    end
+
+    # Main routine. It receive and process event hash objects and make JSON post calls.
+    #
+    # @param [Hash] :h Event Hash object.
+    def run(h)
+      json = handle_by_event(h)
+      post(json) if json
+    end
+  end
+end

data/lib/saba-webhook-gateway/googlechat.rb

@@ -0,0 +1,326 @@
+# Saba Webhook Gateway for Google Chat
+# Copyright 2023 Kenshi Muto <kmuto@kmuto.jp>
+require_relative 'base'
+require 'faraday'
+
+module SabaWebhookGateway
+  class GoogleChat < Base
+    # Make Google Chat Card style JSON.
+    #
+    # @param [Hash] :header Header area Hash object.
+    # @param [Hash] :sections Section area Hash object.
+    # @return [String]
+    def googlechat_card(header, sections)
+      j = { cards: { header: header, sections: sections } }
+      JSON.generate(j)
+    end
+
+    def sample(h)
+      header = { title: 'notification test' }
+      widget1 = [{ textParagraph: { text: h[:message] } }]
+      sections = [{ widgets: widget1 }]
+      googlechat_card(header, sections)
+    end
+
+    def alert(h)
+      header = { title: %Q([#{h[:orgName]}] #{h[:alert][:status].upcase}: #{h[:alert][:monitorName]}) }
+      start_time = to_date(h[:alert][:openedAt])
+      end_time = h[:alert][:closedAt] ? to_date(h[:alert][:closedAt]) : nil
+      header[:subtitle] = if end_time
+                            %Q(from #{start_time} to #{end_time})
+                          else
+                            %Q(from #{start_time})
+                          end
+
+      sa = []
+      sa << %Q(<a href="#{h[:alert][:url]}">View Alert</a>)
+
+      if h[:host] && h[:host][:roles]
+        # Host
+        sa << %Q(Host: <a href="#{h[:host][:url]}">#{h[:host][:name]}</a>)
+        h[:host][:roles].each do |a|
+          sa << %Q(Role: [<a href="#{a[:serviceUrl]}">#{a[:serviceName]}</a>] <a href="#{a[:roleUrl]}">#{a[:roleName]}</a>)
+        end
+      end
+
+      if h[:service] && h[:service][:roles]
+        # Service
+        sa << %Q(Service: #{h[:service][:name]})
+        h[:service][:roles].each do |a|
+          sa << %Q(Role: [<a href="#{a[:serviceUrl]}">#{a[:serviceName]}</a>] <a href="#{a[:roleUrl]}">#{a[:roleName]}</a>)
+        end
+      end
+
+      if h[:alert][:metricLabel]
+        # Host, Service, Expression
+        if h[:alert][:status] == 'ok'
+          sa << %Q(Metric: #{h[:alert][:metricLabel]} #{h[:alert][:metricValue]})
+        else
+          threshold = if h[:alert][:status] == 'critical'
+                        h[:alert][:criticalThreshold]
+                      else
+                        h[:alert][:warningThreshold]
+                      end
+          sa << %Q(Metric: #{h[:alert][:metricLabel]} #{h[:alert][:metricValue]} #{h[:alert][:monitorOperator]} #{threshold})
+        end
+      end
+
+      widget1 = [{ textParagraph: { text: sa.join("\n") } }]
+      sections = [{ widgets: widget1 }]
+
+      if h[:imageUrl]
+        widget2 = [{
+          image: {
+            imageUrl: h[:imageUrl],
+            onClick: {
+              openLink: {
+                url: h[:alert][:url]
+              }
+            }
+          }
+        }]
+        sections.push({ widgets: widget2 })
+      end
+
+      if h[:memo]
+        widget3 = [{ textParagraph: { text: h[:memo] } }]
+        sections.push({ widgets: widget3 })
+      end
+
+      googlechat_card(header, sections)
+    end
+
+    def alert_group(h)
+      header = { title: %Q([#{h[:orgName]}] #{h[:alertGroup][:status].upcase}: #{h[:alertGroupSetting][:name]}) }
+      start_time = to_date(h[:alertGroup][:createdAt])  # createdAt
+      end_time = h[:alertGroup][:closedAt] ? to_date(h[:alertGroup][:closedAt]) : nil
+      header[:subtitle] = if end_time
+                            %Q(from #{start_time} to #{end_time})
+                          else
+                            %Q(from #{start_time})
+                          end
+
+      sa = []
+      sa << %Q(<a href="#{h[:alertGroup][:url]}">View Alert</a>)
+
+      widget1 = [{ textParagraph: { text: sa.join("\n") } }]
+      sections = [{ widgets: widget1 }]
+
+      if h[:alertGroupSetting][:memo]
+        widget2 = [{ textParagraph: { text: h[:alertGroupSetting][:memo] } }]
+        sections.push({ widgets: widget2 })
+      end
+
+      googlechat_card(header, sections)
+    end
+
+    def host_register(h)
+      header = { title: %Q([#{h[:orgName]}] Host #{h[:host][:name]} is registered) }
+
+      sa = []
+      if h[:user]
+        sa << %Q(Registered by: #{h[:user][:screenName]})
+      end
+
+      if h[:host][:roles]
+        sa << %Q(Host: <a href="#{h[:host][:url]}">#{h[:host][:name]}</a>)
+        h[:host][:roles].each do |a|
+          sa << %Q(Role: [<a href="#{a[:serviceUrl]}">#{a[:serviceName]}</a>] <a href="#{a[:roleUrl]}">#{a[:roleName]}</a>)
+        end
+      end
+
+      widget1 = [{ textParagraph: { text: sa.join("\n") } }]
+      sections = [{ widgets: widget1 }]
+
+      googlechat_card(header, sections)
+    end
+
+    def host_status(h)
+      header = { title: %Q([#{h[:orgName]}] Host #{h[:host][:name]} is changed to #{h[:host][:status]}) }
+
+      sa = []
+      if h[:user]
+        sa << %Q(Chagned by: #{h[:user][:screenName]})
+      end
+
+      sa << %Q(Previous: #{h[:fromStatus]})
+      if h[:host][:roles]
+        sa << %Q(Host: <a href="#{h[:host][:url]}">#{h[:host][:name]}</a>)
+        h[:host][:roles].each do |a|
+          sa << %Q(Role: [<a href="#{a[:serviceUrl]}">#{a[:serviceName]}</a>] <a href="#{a[:roleUrl]}">#{a[:roleName]}</a>)
+        end
+      end
+
+      widget1 = [{ textParagraph: { text: sa.join("\n") } }]
+      sections = [{ widgets: widget1 }]
+
+      googlechat_card(header, sections)
+    end
+
+    def host_retire(h)
+      header = { title: %Q([#{h[:orgName]}] Host #{h[:host][:name]} is retired) }
+
+      sa = []
+      if h[:user]
+        sa << %Q(Retired by: #{h[:user][:screenName]})
+      end
+
+      if h[:host][:roles]
+        sa << %Q(Host: <a href="#{h[:host][:url]}">#{h[:host][:name]}</a>)
+        h[:host][:roles].each do |a|
+          sa << %Q(Role: [<a href="#{a[:serviceUrl]}">#{a[:serviceName]}</a>] <a href="#{a[:roleUrl]}">#{a[:roleName]}</a>)
+        end
+      end
+
+      widget1 = [{ textParagraph: { text: sa.join("\n") } }]
+      sections = [{ widgets: widget1 }]
+
+      googlechat_card(header, sections)
+    end
+
+    def monitor_create_common(h, target)
+      header = { title: %Q([#{h[:orgName]}] Monitor #{h[:monitor][:name]} is created) }
+
+      sa = []
+      if h[:user]
+        sa << %Q(Created by: #{h[:user][:screenName]})
+      end
+
+      sa << target
+
+      widget1 = [{ textParagraph: { text: sa.join("\n") } }]
+      sections = [{ widgets: widget1 }]
+
+      if h[:monitor][:memo]
+        widget2 = [{ textParagraph: { text: h[:monitor][:memo] } }]
+        sections.push({ widgets: widget2 })
+      end
+
+      googlechat_card(header, sections)
+    end
+
+    def monitor_create_host(h)
+      monitor_create_common(h, %Q(Target: Host metric (#{h[:monitor][:metric]})))
+    end
+
+    def monitor_create_external(h)
+      monitor_create_common(h, %Q(Target: External (#{h[:monitor][:url]})))
+    end
+
+    def monitor_create_expression(h)
+      monitor_create_common(h, %Q(Target: Expression (#{h[:monitor][:expression]})))
+    end
+
+    def monitor_create_anomaly_detection(h)
+      monitor_create_common(h, %Q(Target: Anormaly detection (#{h[:monitor][:scopes].join(', ')})))
+    end
+
+    def monitor_create_service(h)
+      monitor_create_common(h, %Q(Target: Service metric (#{h[:monitor][:metric]})))
+    end
+
+    def monitor_create_connectivity(h)
+      monitor_create_common(h, %Q(Target: Connectivity (#{h[:monitor][:scopes].join(', ')})))
+    end
+
+    def monitor_update_common(h, target)
+      header = { title: %Q([#{h[:orgName]}] Monitor #{h[:monitor][:name]} is updated) }
+
+      sa = []
+      if h[:user]
+        sa << %Q(Updated by: #{h[:user][:screenName]})
+      end
+
+      sa << target
+
+      widget1 = [{ textParagraph: { text: sa.join("\n") } }]
+      sections = [{ widgets: widget1 }]
+
+      if h[:monitor][:memo]
+        widget2 = [{ textParagraph: { text: h[:monitor][:memo] } }]
+        sections.push({ widgets: widget2 })
+      end
+
+      googlechat_card(header, sections)
+    end
+
+    def monitor_update_host(h)
+      monitor_update_common(h, %Q(Target: Host metric (#{h[:monitor][:metric]})))
+    end
+
+    def monitor_update_external(h)
+      monitor_update_common(h, %Q(Target: External (#{h[:monitor][:url]})))
+    end
+
+    def monitor_update_expression(h)
+      monitor_update_common(h, %Q(Target: Expression (#{h[:monitor][:expression]})))
+    end
+
+    def monitor_update_anomaly_detection(h)
+      monitor_update_common(h, %Q(Target: Anormaly detection (#{h[:monitor][:scopes].join(', ')})))
+    end
+
+    def monitor_update_service(h)
+      monitor_update_common(h, %Q(Target: Service metric (#{h[:monitor][:metric]})))
+    end
+
+    def monitor_update_connectivity(h)
+      monitor_update_common(h, %Q(Target: Connectivity (#{h[:monitor][:scopes].join(', ')})))
+    end
+
+    def monitor_delete_common(h, target)
+      header = { title: %Q([#{h[:orgName]}] Monitor #{h[:monitor][:name]} is deleted) }
+
+      sa = []
+      if h[:user]
+        sa << %Q(Deleted by: #{h[:user][:screenName]})
+      end
+
+      sa << target
+
+      widget1 = [{ textParagraph: { text: sa.join("\n") } }]
+      sections = [{ widgets: widget1 }]
+
+      if h[:monitor][:memo]
+        widget2 = [{ textParagraph: { text: h[:monitor][:memo] } }]
+        sections.push({ widgets: widget2 })
+      end
+
+      googlechat_card(header, sections)
+    end
+
+    def monitor_delete_host(h)
+      monitor_delete_common(h, %Q(Target: Host metric (#{h[:monitor][:metric]})))
+    end
+
+    def monitor_delete_external(h)
+      monitor_delete_common(h, %Q(Target: External (#{h[:monitor][:url]})))
+    end
+
+    def monitor_delete_expression(h)
+      monitor_delete_common(h, %Q(Target: Expression (#{h[:monitor][:expression]})))
+    end
+
+    def monitor_delete_anomaly_detection(h)
+      monitor_delete_common(h, %Q(Target: Anormaly detection (#{h[:monitor][:scopes].join(', ')})))
+    end
+
+    def monitor_delete_service(h)
+      monitor_delete_common(h, %Q(Target: Service metric (#{h[:monitor][:metric]})))
+    end
+
+    def monitor_delete_connectivity(h)
+      monitor_delete_common(h, %Q(Target: Connectivity (#{h[:monitor][:scopes].join(', ')})))
+    end
+
+    def post(json)
+      resp = Faraday.post(ENV['GOOGLECHAT_WEBHOOK']) do |req|
+        req.headers['Content-Type'] = 'application/json'
+        req.body = json
+      end
+      if @debug
+        p("[post]\n#{resp.body}")
+      end
+    end
+  end
+end

data/lib/saba-webhook-gateway.rb

@@ -0,0 +1,5 @@
+# Saba Webhook Gateway
+#
+# Copyright 2023 Kenshi Muto <kmuto@kmuto.jp>
+require_relative 'saba-webhook-gateway/base'
+require_relative 'saba-webhook-gateway/googlechat'

data/make-lambda-zip.sh

@@ -0,0 +1,7 @@
+#!/bin/sh
+bundle config set --local path 'vendor/bundle'
+rm -rf vendor saba-webhook-gateway-googlechat.zip
+bundle install --gemfile Gemfile-lambda
+mv vendor/bundle/ruby/3.1.0 vendor/bundle/ruby/3.2.0
+bundle config unset --local path
+zip -r saba-webhook-gateway-googlechat.zip exe/lambda-handler-googlechat.rb customize.rb lib vendor