# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dynatrace Log Monitoring API v2 Logs API
  version: 1.0.0
extends: openapi/dynatrace-logs-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/logs/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search log records
      effect: read
      questions:
      - How do I find error logs from the past hour in Grail?
      - Can I sort log search results and choose which fields come back?
      instructions:
      - text: Search logs for {query} between {from} and {to}.
        slots:
          query: query.query
          from: query.from
          to: query.to
      - text: Find up to {limit} log lines matching {query}.
        slots:
          limit: query.limit
          query: query.query
      method: generated
      generated: '2026-09-26'
- target: $.paths['/logs/ingest'].post
  update:
    x-apievangelist-phrasing:
      intent: Send log records into Grail
      effect: write
      questions:
      - Can I push my application's log lines straight into Dynatrace?
      - What fields does each ingested log record need?
      instructions:
      - text: Ingest this batch of log records into Grail.
      - text: Send these application log messages to Dynatrace.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/logs/aggregate'].get
  update:
    x-apievangelist-phrasing:
      intent: Aggregate log records by fields
      effect: read
      questions:
      - How many errors did each service log today?
      - Can I count log volume grouped by severity?
      instructions:
      - text: Count logs matching {query} grouped by {groupBy}.
        slots:
          query: query.query
          groupBy: query.groupBy
      - text: Summarize log volume by {groupBy} from {from} to {to}.
        slots:
          groupBy: query.groupBy
          from: query.from
          to: query.to
      method: generated
      generated: '2026-09-26'
- target: $.paths['/logs/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export log records in bulk
      effect: read
      questions:
      - What's the best way to bulk-export logs to a SIEM or archive?
      - Can I pull all matching log records out in pages for archiving?
      instructions:
      - text: Export all logs matching {query} from {from} to {to} for archiving.
        slots:
          query: query.query
          from: query.from
          to: query.to
      - text: Bulk-export log records {size} per page with fields {fields}.
        slots:
          size: query.pageSize
          fields: query.fields
      method: generated
      generated: '2026-09-26'