read_counters

{
  "name": "read_counters",
  "resource": "environment",
  "tier": "observe",
  "summary": "The environment's counter totals by name over a window, at the hour or day grain (the logging service).",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true
  }
}

{
  "name": "read_counters",
  "tier": "observe",
  "scenario": "CHI-L0-09",
  "summary": "Read a deployed application's counter totals for one environment — each counter by name, summed per hour or per day over a time window. The counters are the ones the application's own code writes through the Logging package, so a window it wrote none in answers no bucket; the platform's own usage, its backend actions and transferred bytes among them, is read with `read_usage`.",
  "owners": [
    "PLD-L0-40",
    "LGS-L0-15"
  ]
}

{
  "request": {
    "type": "object",
    "required": [
      "application",
      "environment"
    ],
    "properties": {
      "application": {
        "type": "string",
        "description": "The application id, from `list_applications`."
      },
      "environment": {
        "type": "string",
        "description": "The stream to read: `development` or `production`, or `local` for the developer-machine stream."
      },
      "name": {
        "type": "string",
        "description": "One counter's name; omitted, every counter."
      },
      "grain": {
        "type": "string",
        "description": "`hour` or `day`; `day` where none is given."
      },
      "since": {
        "type": "string",
        "description": "Inclusive start of the time window. Use YYYY-MM-DD followed by T (or t), HH:mm, optional :ss, an optional decimal fraction of 1–9 digits after seconds, then Z (or z) or a signed HH:mm offset. The calendar date must exist; hours are 00–23, minutes and seconds 00–59, and offset hours/minutes 00–23/00–59. Leap seconds and 24:00 are not accepted. Values normalize to UTC at millisecond precision. Omission leaves this bound open; the HTTP action returns 400 invalid_request naming the member for null, empty strings, wrong types, or malformed values. MCP rejects wrong argument types before action dispatch."
      },
      "until": {
        "type": "string",
        "description": "Inclusive end of the time window. Use YYYY-MM-DD followed by T (or t), HH:mm, optional :ss, an optional decimal fraction of 1–9 digits after seconds, then Z (or z) or a signed HH:mm offset. The calendar date must exist; hours are 00–23, minutes and seconds 00–59, and offset hours/minutes 00–23/00–59. Leap seconds and 24:00 are not accepted. Values normalize to UTC at millisecond precision. Omission leaves this bound open; the HTTP action returns 400 invalid_request naming the member for null, empty strings, wrong types, or malformed values. MCP rejects wrong argument types before action dispatch."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "description": "The most bucket rows answered, in bucket order; clamped to 1,000, the read ceiling, and the ceiling where omitted. A malformed value is ignored."
      }
    }
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "environment",
      "grain",
      "buckets"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "reference": {
        "type": "string",
        "pattern": "^[0-9a-f]{10}$",
        "description": "The short reference the platform recorded this call under, ten lowercase hexadecimal characters, the value the call’s record row carries; quote it when reporting the call."
      },
      "environment": {
        "type": "string"
      },
      "grain": {
        "type": "string"
      },
      "buckets": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "name",
            "bucket_start",
            "total"
          ],
          "properties": {
            "name": {
              "type": "string"
            },
            "bucket_start": {
              "type": "string"
            },
            "total": {
              "type": "integer"
            }
          }
        }
      }
    }
  }
}