lex-dynatrace 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ce656ccaf788e435189fc8eb6c7fb12e948cca86e689624e7d26877c8c5cdd6a
+  data.tar.gz: 842b834a51a6e0eb79c1797a7d20e741a773f39660d1d6fe2256ee8c421ce073
+SHA512:
+  metadata.gz: 52dfafa4209ea9c3a6297e33567a51afdad9007c3227c162fb31582838c96400249241d926a339379abef63ffc28f14cc47bc95d6ab1ee343819485207045c66
+  data.tar.gz: 1f42b39b83e1d41cbb192c45a009ce0a687a0ee0181ed90509d8374cc4e63665c8bd57d0d60d3e7e2bcb1727fe5a3577a49954132c21c0ef8620dd218efa87b0

data/.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+  schedule:
+    - cron: '0 9 * * 1'
+
+jobs:
+  ci:
+    uses: LegionIO/.github/.github/workflows/ci.yml@main
+
+  lint:
+    uses: LegionIO/.github/.github/workflows/lint-patterns.yml@main
+
+  security:
+    uses: LegionIO/.github/.github/workflows/security-scan.yml@main
+
+  version-changelog:
+    uses: LegionIO/.github/.github/workflows/version-changelog.yml@main
+
+  dependency-review:
+    uses: LegionIO/.github/.github/workflows/dependency-review.yml@main
+
+  stale:
+    if: github.event_name == 'schedule'
+    uses: LegionIO/.github/.github/workflows/stale.yml@main
+
+  release:
+    needs: [ci, lint]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    uses: LegionIO/.github/.github/workflows/release.yml@main
+    secrets:
+      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}

data/.rubocop.yml

@@ -0,0 +1,31 @@
+AllCops:
+  TargetRubyVersion: 3.4
+  NewCops: enable
+  SuggestExtensions: false
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - '*.gemspec'
+
+Style/Documentation:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Max: 10
+  CountKeywordArgs: false
+
+Metrics/MethodLength:
+  Max: 25
+
+Metrics/AbcSize:
+  Max: 25
+
+Metrics/CyclomaticComplexity:
+  Max: 12
+
+Metrics/PerceivedComplexity:
+  Max: 12
+
+Layout/LineLength:
+  Max: 120

data/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+## [0.1.0] - 2026-03-27
+
+### Added
+- Initial release with 16 sub-modules covering Dynatrace Environment API v2
+- Metrics: list descriptors, get descriptor, query data points, ingest custom metrics
+- Entities: list/get entities, list/get entity types
+- Problems: list/get/close problems, list/create comments
+- Events: list/get events, ingest custom events
+- Logs: search and aggregate log data
+- Audit Logs: list/get audit log entries
+- ActiveGates: list/get ActiveGate instances
+- Extensions 2.0: full extension lifecycle, environment config, monitoring configurations
+- SLOs: CRUD for service level objectives
+- Synthetic: monitor CRUD, locations, execution reports
+- Security Problems: list/get/mute/unmute, remediations
+- Settings Objects: CRUD for settings objects and schemas
+- Network Zones: CRUD for network zones
+- Tags: get/add/delete entity tags
+- API Tokens: CRUD, lookup
+- Releases: list/get release information
+- Standalone Client class per sub-module (lex-cloudflare multi-module pattern)
+- 66 specs with WebMock stubs

data/Gemfile

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :test do
+  gem 'rspec', '~> 3.12'
+  gem 'rubocop', '~> 1.50'
+  gem 'rubocop-rspec', '~> 2.22'
+  gem 'simplecov', '~> 0.22'
+  gem 'webmock', '~> 3.18'
+end

data/README.md

@@ -0,0 +1,92 @@
+# lex-dynatrace
+
+Legion Extension for the [Dynatrace Environment API v2](https://docs.dynatrace.com/docs/dynatrace-api/environment-api). Multi-module monolith covering 16 API areas with standalone clients.
+
+## Installation
+
+```ruby
+gem 'lex-dynatrace'
+```
+
+## Authentication
+
+All sub-modules authenticate via `Api-Token` header. Generate a token in **Dynatrace > Access tokens** with the scopes you need.
+
+## Usage
+
+Each sub-module has its own `Client` class that can be used standalone (no Legion runtime required):
+
+```ruby
+require 'legion/extensions/dynatrace'
+
+# Metrics
+metrics = Legion::Extensions::Dynatrace::Metrics::Client.new(
+  environment_url: 'https://abc12345.live.dynatrace.com',
+  api_token: 'dt0c01.xxxx'
+)
+metrics.query(metric_selector: 'builtin:host.cpu.usage', from: 'now-1h')
+metrics.list_descriptors
+metrics.ingest(lines: ['custom.metric 42'])
+
+# Problems
+problems = Legion::Extensions::Dynatrace::Problems::Client.new(
+  environment_url: 'https://abc12345.live.dynatrace.com',
+  api_token: 'dt0c01.xxxx'
+)
+problems.list_problems(from: 'now-24h')
+problems.close_problem(problem_id: 'P-123', message: 'resolved')
+
+# Entities
+entities = Legion::Extensions::Dynatrace::Entities::Client.new(
+  environment_url: 'https://abc12345.live.dynatrace.com',
+  api_token: 'dt0c01.xxxx'
+)
+entities.list_entities(entity_selector: 'type(HOST)')
+entities.get_entity(entity_id: 'HOST-ABC123')
+```
+
+## Sub-Modules
+
+| Module | API Path | Methods |
+|--------|----------|---------|
+| **Metrics** | `/api/v2/metrics` | `list_descriptors`, `get_descriptor`, `query`, `ingest` |
+| **Entities** | `/api/v2/entities` | `list_entities`, `get_entity`, `list_entity_types`, `get_entity_type` |
+| **Problems** | `/api/v2/problems` | `list_problems`, `get_problem`, `close_problem`, `list_comments`, `create_comment` |
+| **Events** | `/api/v2/events` | `list_events`, `get_event`, `ingest_event` |
+| **Logs** | `/api/v2/logs` | `search_logs`, `aggregate_logs` |
+| **AuditLogs** | `/api/v2/auditlogs` | `list_audit_logs`, `get_audit_log` |
+| **ActiveGates** | `/api/v2/activeGates` | `list_active_gates`, `get_active_gate` |
+| **Extensions20** | `/api/v2/extensions` | `list_extensions`, `get_extension`, `delete_extension`, `get_extension_version`, `delete_extension_version`, `get_environment_config`, `update_environment_config`, `delete_environment_config`, `list_monitoring_configs`, `get_monitoring_config`, `create_monitoring_config`, `update_monitoring_config`, `delete_monitoring_config` |
+| **Slos** | `/api/v2/slo` | `list_slos`, `get_slo`, `create_slo`, `update_slo`, `delete_slo` |
+| **Synthetic** | `/api/v2/synthetic` | `list_monitors`, `get_monitor`, `create_monitor`, `update_monitor`, `delete_monitor`, `get_execution`, `list_locations`, `get_location` |
+| **SecurityProblems** | `/api/v2/securityProblems` | `list_security_problems`, `get_security_problem`, `mute_security_problem`, `unmute_security_problem`, `list_remediations` |
+| **SettingsObjects** | `/api/v2/settings` | `list_objects`, `get_object`, `create_objects`, `update_object`, `delete_object`, `list_schemas`, `get_schema` |
+| **NetworkZones** | `/api/v2/networkZones` | `list_network_zones`, `get_network_zone`, `create_network_zone`, `update_network_zone`, `delete_network_zone` |
+| **Tags** | `/api/v2/tags` | `get_tags`, `add_tags`, `delete_tag` |
+| **Tokens** | `/api/v2/apiTokens` | `list_tokens`, `get_token`, `create_token`, `update_token`, `delete_token`, `lookup_token` |
+| **Releases** | `/api/v2/releases` | `list_releases`, `get_release` |
+
+## Legion Settings
+
+When running inside the Legion framework, credentials resolve from settings:
+
+```json
+{
+  "lex-dynatrace": {
+    "environment_url": "https://abc12345.live.dynatrace.com",
+    "api_token": "vault://secret/dynatrace#api_token"
+  }
+}
+```
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec       # 66 specs
+bundle exec rubocop     # 0 offenses
+```
+
+## License
+
+MIT

data/lex-dynatrace.gemspec

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative 'lib/legion/extensions/dynatrace/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'lex-dynatrace'
+  spec.version       = Legion::Extensions::Dynatrace::VERSION
+  spec.authors       = ['Esity']
+  spec.email         = ['matthewdiverson@gmail.com']
+
+  spec.summary       = 'LEX::Dynatrace'
+  spec.description   = 'Used to connect Legion to Dynatrace SaaS Environment API v2'
+  spec.homepage      = 'https://github.com/LegionIO/lex-dynatrace'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.4'
+
+  spec.metadata['homepage_uri']          = spec.homepage
+  spec.metadata['source_code_uri']       = 'https://github.com/LegionIO/lex-dynatrace'
+  spec.metadata['changelog_uri']         = 'https://github.com/LegionIO/lex-dynatrace/blob/main/CHANGELOG.md'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'faraday', '>= 2.0'
+  spec.add_dependency 'legion-cache', '>= 1.3.11'
+  spec.add_dependency 'legion-crypt', '>= 1.4.9'
+  spec.add_dependency 'legion-data', '>= 1.4.17'
+  spec.add_dependency 'legion-json', '>= 1.2.1'
+  spec.add_dependency 'legion-logging', '>= 1.3.2'
+  spec.add_dependency 'legion-settings', '>= 1.3.14'
+  spec.add_dependency 'legion-transport', '>= 1.3.9'
+end

data/lib/legion/extensions/dynatrace/active_gates/client.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative '../helpers/client'
+require_relative '../base_client'
+require_relative 'runners/active_gates'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module ActiveGates
+        class Client < Legion::Extensions::Dynatrace::BaseClient
+          include Runners::ActiveGates
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/active_gates/runners/active_gates.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module ActiveGates
+        module Runners
+          module ActiveGates
+            def list_active_gates(hostname: nil, os_type: nil, network_zone: nil, update_status: nil,
+                                  version_compare_type: nil, version: nil, group: nil,
+                                  page_size: nil, next_page_key: nil, **opts)
+              conn = opts[:connection] || connection(**opts)
+              params = {}
+              params[:hostname] = hostname if hostname
+              params[:osType] = os_type if os_type
+              params[:networkZone] = network_zone if network_zone
+              params[:updateStatus] = update_status if update_status
+              params[:versionCompareType] = version_compare_type if version_compare_type
+              params[:version] = version if version
+              params[:group] = group if group
+              params[:pageSize] = page_size if page_size
+              params[:nextPageKey] = next_page_key if next_page_key
+              conn.get('api/v2/activeGates', params).body
+            end
+
+            def get_active_gate(ag_id:, **opts)
+              conn = opts[:connection] || connection(**opts)
+              conn.get("api/v2/activeGates/#{ag_id}").body
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/active_gates.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative 'active_gates/runners/active_gates'
+require_relative 'active_gates/client'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module ActiveGates
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/attacks/client.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative '../helpers/client'
+require_relative '../base_client'
+require_relative 'runners/attacks'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module Attacks
+        class Client < Legion::Extensions::Dynatrace::BaseClient
+          include Runners::Attacks
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/attacks/runners/attacks.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module Attacks
+        module Runners
+          module Attacks
+            def list_attacks(attack_selector: nil, from: nil, to: nil, fields: nil, sort: nil,
+                             page_size: nil, next_page_key: nil, **opts)
+              conn = opts[:connection] || connection(**opts)
+              params = {}
+              params[:attackSelector] = attack_selector if attack_selector
+              params[:from] = from if from
+              params[:to] = to if to
+              params[:fields] = fields if fields
+              params[:sort] = sort if sort
+              params[:pageSize] = page_size if page_size
+              params[:nextPageKey] = next_page_key if next_page_key
+              conn.get('api/v2/attacks', params).body
+            end
+
+            def get_attack(attack_id:, fields: nil, **opts)
+              conn = opts[:connection] || connection(**opts)
+              params = {}
+              params[:fields] = fields if fields
+              conn.get("api/v2/attacks/#{attack_id}", params).body
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/attacks.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative 'attacks/runners/attacks'
+require_relative 'attacks/client'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module Attacks
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/audit_logs/client.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative '../helpers/client'
+require_relative '../base_client'
+require_relative 'runners/audit_logs'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module AuditLogs
+        class Client < Legion::Extensions::Dynatrace::BaseClient
+          include Runners::AuditLogs
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/audit_logs/runners/audit_logs.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module AuditLogs
+        module Runners
+          module AuditLogs
+            def list_audit_logs(filter: nil, from: nil, to: nil, sort: nil,
+                                page_size: nil, next_page_key: nil, **opts)
+              conn = opts[:connection] || connection(**opts)
+              params = {}
+              params[:filter] = filter if filter
+              params[:from] = from if from
+              params[:to] = to if to
+              params[:sort] = sort if sort
+              params[:pageSize] = page_size if page_size
+              params[:nextPageKey] = next_page_key if next_page_key
+              conn.get('api/v2/auditlogs', params).body
+            end
+
+            def get_audit_log(log_id:, **opts)
+              conn = opts[:connection] || connection(**opts)
+              conn.get("api/v2/auditlogs/#{log_id}").body
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/audit_logs.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative 'audit_logs/runners/audit_logs'
+require_relative 'audit_logs/client'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module AuditLogs
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/base_client.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Dynatrace
+      class BaseClient
+        include Helpers::Client
+
+        attr_reader :opts
+
+        def initialize(environment_url:, api_token: nil, **extra)
+          @opts = { environment_url: environment_url, api_token: api_token, **extra }.compact
+        end
+
+        def settings
+          { options: @opts }
+        end
+
+        def connection(**override)
+          super(**@opts, **override)
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/business_events/client.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative '../helpers/client'
+require_relative '../base_client'
+require_relative 'runners/business_events'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module BusinessEvents
+        class Client < Legion::Extensions::Dynatrace::BaseClient
+          include Runners::BusinessEvents
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/business_events/runners/business_events.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module BusinessEvents
+        module Runners
+          module BusinessEvents
+            def ingest_business_event(data:, **opts)
+              env_url = opts[:environment_url] || self.opts[:environment_url]
+              token = opts[:api_token] || self.opts[:api_token]
+              json_conn = Faraday.new(url: env_url) do |f|
+                f.headers['Authorization'] = "Api-Token #{token}" if token
+                f.headers['Content-Type'] = 'application/cloudevents+json'
+                f.response :json
+                f.adapter Faraday.default_adapter
+              end
+              json_conn.post('api/v2/bizevents/ingest', data.to_json).body
+            end
+
+            def ingest_business_events_batch(events:, **opts)
+              env_url = opts[:environment_url] || self.opts[:environment_url]
+              token = opts[:api_token] || self.opts[:api_token]
+              batch_conn = Faraday.new(url: env_url) do |f|
+                f.headers['Authorization'] = "Api-Token #{token}" if token
+                f.headers['Content-Type'] = 'application/cloudevents-batch+json'
+                f.response :json
+                f.adapter Faraday.default_adapter
+              end
+              batch_conn.post('api/v2/bizevents/ingest', events.to_json).body
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/business_events.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative 'business_events/runners/business_events'
+require_relative 'business_events/client'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module BusinessEvents
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/credentials/client.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative '../helpers/client'
+require_relative '../base_client'
+require_relative 'runners/credentials'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module Credentials
+        class Client < Legion::Extensions::Dynatrace::BaseClient
+          include Runners::Credentials
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/credentials/runners/credentials.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module Credentials
+        module Runners
+          module Credentials
+            def list_credentials(name: nil, type: nil, scope: nil,
+                                 page_size: nil, next_page_key: nil, **opts)
+              conn = opts[:connection] || connection(**opts)
+              params = {}
+              params[:name] = name if name
+              params[:type] = type if type
+              params[:scope] = scope if scope
+              params[:pageSize] = page_size if page_size
+              params[:nextPageKey] = next_page_key if next_page_key
+              conn.get('api/v2/credentials', params).body
+            end
+
+            def get_credential(credential_id:, **opts)
+              conn = opts[:connection] || connection(**opts)
+              conn.get("api/v2/credentials/#{credential_id}").body
+            end
+
+            def create_credential(credential:, **opts)
+              conn = opts[:connection] || connection(**opts)
+              conn.post('api/v2/credentials', credential).body
+            end
+
+            def update_credential(credential_id:, credential:, **opts)
+              conn = opts[:connection] || connection(**opts)
+              conn.put("api/v2/credentials/#{credential_id}", credential).body
+            end
+
+            def delete_credential(credential_id:, **opts)
+              conn = opts[:connection] || connection(**opts)
+              conn.delete("api/v2/credentials/#{credential_id}").body
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/credentials.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative 'credentials/runners/credentials'
+require_relative 'credentials/client'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module Credentials
+      end
+    end
+  end
+end

data/lib/legion/extensions/dynatrace/deployment/client.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative '../helpers/client'
+require_relative '../base_client'
+require_relative 'runners/deployment'
+
+module Legion
+  module Extensions
+    module Dynatrace
+      module Deployment
+        class Client < Legion::Extensions::Dynatrace::BaseClient
+          include Runners::Deployment
+        end
+      end
+    end
+  end
+end