# SystemStatusArchiver

Estrutura de dados do contrato OpenAPI.

## Campos

| Campo | Tipo | Presença | Descrição |
|---|---|---|---|
| `archiveTimeoutSeconds` | `number / null` | opcional | — |
| `archivedCount` | `integer` | obrigatório | Mínimo: `0` |
| `available` | `boolean` | obrigatório | — |
| `backlogErrorCode` | `string` | opcional | Valores: `"archiver_backlog_unavailable"` |
| `commandSource` | `string` | opcional | Origem enumerada de pg_settings.source; nunca o comando, caminho ou conteúdo da configuração. Valores: `"unknown"`, `"default"`, `"environment variable"`, `"configuration file"`, `"command line"`, `"global"`, `"database"`, `"user"`, `"database user"`, `"client"`, `"override"`, `"interactive"`, `"test"`, `"session"` |
| `errorCode` | `string` | opcional | Valores: `"database_unavailable"`, `"archiver_stats_unavailable"`, `"monitoring_unsupported"` |
| `failedCount` | `integer` | obrigatório | Falhas acumuladas desde statsResetAt; não indica, isoladamente, falha atual. Mínimo: `0` |
| `lastArchivedAt` | `string / null` | opcional | — |
| `lastFailedAt` | `string / null` | opcional | — |
| `mode` | `string` | opcional | Valores: `"off"`, `"on"`, `"always"` |
| `readyFiles` | `integer / null` | opcional | — |
| `segmentBytes` | `integer / null` | opcional | — |
| `statsResetAt` | `string / null` | opcional | — |
| `status` | `string` | obrigatório | blocked: última falha posterior ao último sucesso e readyFiles>0. failedCount é cumulativo e sozinho não dispara alarme. disabled corresponde a archive_mode=off. degraded indica backlog não consultável. Valores: `"ok"`, `"disabled"`, `"degraded"`, `"blocked"`, `"unavailable"` |
| `timeoutSource` | `string` | opcional | Origem enumerada de pg_settings.source; nunca o comando, caminho ou conteúdo da configuração. Valores: `"unknown"`, `"default"`, `"environment variable"`, `"configuration file"`, `"command line"`, `"global"`, `"database"`, `"user"`, `"database user"`, `"client"`, `"override"`, `"interactive"`, `"test"`, `"session"` |
| `walBytes` | `integer / null` | opcional | — |

## Definição OpenAPI

```json
{
  "additionalProperties": true,
  "properties": {
    "archiveTimeoutSeconds": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "archivedCount": {
      "minimum": 0,
      "type": "integer"
    },
    "available": {
      "type": "boolean"
    },
    "backlogErrorCode": {
      "enum": [
        "archiver_backlog_unavailable"
      ],
      "type": "string"
    },
    "commandSource": {
      "description": "Origem enumerada de pg_settings.source; nunca o comando, caminho ou conteúdo da configuração.",
      "enum": [
        "unknown",
        "default",
        "environment variable",
        "configuration file",
        "command line",
        "global",
        "database",
        "user",
        "database user",
        "client",
        "override",
        "interactive",
        "test",
        "session"
      ],
      "type": "string"
    },
    "errorCode": {
      "enum": [
        "database_unavailable",
        "archiver_stats_unavailable",
        "monitoring_unsupported"
      ],
      "type": "string"
    },
    "failedCount": {
      "description": "Falhas acumuladas desde statsResetAt; não indica, isoladamente, falha atual.",
      "minimum": 0,
      "type": "integer"
    },
    "lastArchivedAt": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "lastFailedAt": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "mode": {
      "enum": [
        "off",
        "on",
        "always"
      ],
      "type": "string"
    },
    "readyFiles": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "segmentBytes": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "statsResetAt": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "description": "blocked: última falha posterior ao último sucesso e readyFiles>0. failedCount é cumulativo e sozinho não dispara alarme. disabled corresponde a archive_mode=off. degraded indica backlog não consultável.",
      "enum": [
        "ok",
        "disabled",
        "degraded",
        "blocked",
        "unavailable"
      ],
      "type": "string"
    },
    "timeoutSource": {
      "description": "Origem enumerada de pg_settings.source; nunca o comando, caminho ou conteúdo da configuração.",
      "enum": [
        "unknown",
        "default",
        "environment variable",
        "configuration file",
        "command line",
        "global",
        "database",
        "user",
        "database user",
        "client",
        "override",
        "interactive",
        "test",
        "session"
      ],
      "type": "string"
    },
    "walBytes": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "available",
    "status",
    "archivedCount",
    "failedCount"
  ],
  "type": "object"
}
```