dt-obs-log-semantic-mapping

Suggests and validates Dynatrace semantic dictionary mappings for vendor audit log integrations.

Updated Dec 12, 2025
One-click install
npx skills add https://github.com/ricardojjulia/ESACompanion --skill dt-obs-log-semantic-mapping-ricardojjulia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dt-obs-log-semantic-mapping
Source: https://github.com/ricardojjulia/ESACompanion/tree/main/.github/skills/dt-obs-log-semantic-mapping
Command: npx skills add https://github.com/ricardojjulia/ESACompanion --skill dt-obs-log-semantic-mapping-ricardojjulia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Mapping vendor audit logs (CyberArk, Okta, Azure SignInLogs, GitHub, Akamai) to the Dynatrace log semantic dictionary is error-prone: required fields get buried in the raw content payload, enums are misused, and types diverge from the SD spec. This Skill proposes mappings from raw vendor payloads and validates existing mappings statically or against live tenant data. ## Core Features & Use Cases - Mapping suggestion (Workflow A): Analyze a raw vendor log payload and produce a mapping table, content field promotion plan, gap summary, and OpenPipeline DQL extraction sketch. - Static validation (Workflow B1): Validate a pasted ingested log event against required-field, enum, type, and content-burial rules, producing a diff-highlighted mapping table. - Runtime validation (Workflow B2): Fetch live logs by log.source via DQL, then run full static validation on the fetched records with an aggregated Validation Summary. - Use Case: Given a raw CyberArk MFA challenge payload, generate a semantic mapping with audit.identity, actor.ips, and loglevel derivations plus the OpenPipeline parseJson/fieldsAdd processor rules to promote buried content fields. ## Quick Start Ask the assistant to suggest a Dynatrace semantic dictionary mapping for a pasted raw vendor audit log payload, or to validate an ingested log event for a given log.source.

Frequently Asked Questions about dt-obs-log-semantic-mapping

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map a vendor audit log to the Dynatrace semantic dictionary?▼

Provide a raw vendor log payload and the Skill runs Workflow A: it inventories content fields, maps them to SD fields in priority order, and outputs a mapping table with transforms, a gap summary, and an OpenPipeline extraction sketch. Phase 2 produces a fully mapped sample record after approval.

How do I validate an existing Dynatrace log mapping?▼

Paste an ingested log event for static validation (Workflow B1), or provide a log.source value for runtime validation (Workflow B2), which fetches live records via DQL and then applies the same validation rules. Both produce a diff-highlighted table and discrepancy report.

What is content field burial in Dynatrace log mappings?▼

Burial occurs when fields in the raw content payload could be promoted to top-level semantic attributes but are not. The Skill inventories buried versus promoted fields, scores the gaps, and proposes OpenPipeline parseJson and fieldsAdd rules to fix them.

Which log sources and log classes are supported?▼

Mapped samples cover CyberArk, Okta, Azure SignInLogs, Sonatype, GitHub Advanced Security, and Akamai SIEM. Supported log classes are authentication, authorization, user_action, and HTTP, each with its own required semantic fields.

What are the minimum required fields for a valid log mapping?▼

All classes require timestamp, log.source, content, and loglevel. Audit classes additionally require audit.action and audit.identity, while the HTTP class requires http.request.method, http.response.status_code, and url.path. Sparse mappings meeting only the minimum are valid at medium confidence.

Why does my OpenPipeline extraction rule fail validation?▼

OpenPipeline processors use DQL functions such as parseJson, fieldsAdd, and splitString; non-DQL syntax produces invalid rules. The Skill requires loading the dt-dql-essentials skill before proposing processor rules to ensure valid DQL syntax.