mirror of
https://github.com/Vateron-Media/XC_VM.git
synced 2026-10-04 12:02:33 +02:00
Divarion_D
a453cd9620
The prelude shims (Paths/AppConfig/Binaries/ErrorCodes.php) were deleted and the $rErrorCodes global is gone. Point the developer guides at the new homes: constants → ConstantsInitializer (paths()/appConfig()/binaries() maps), error catalogue → ErrorResponder::codes(). Also refresh the now-outdated "refactored later" note in build/rector.php's skip list. Only docs/en is edited (docs/ru is regenerated from it before a release); make docs-build passes.
93 lines
2.3 KiB
Markdown
93 lines
2.3 KiB
Markdown
# Diagnostics Service
|
|
|
|
`DiagnosticsService` provides operational diagnostics helpers:
|
|
|
|
- SSL certificate inspection
|
|
- codec compatibility checks
|
|
- panel log export/submission
|
|
- external API IP detection
|
|
|
|
---
|
|
|
|
## Methods
|
|
|
|
### `getCertificateInfo(?string $certificate = null): ?array`
|
|
|
|
Returns certificate details (`serial`, `expiration`, `subject`, `path`).
|
|
|
|
If `$certificate` is null, certificate path is auto-detected from nginx SSL config.
|
|
Returns `null` if file is missing or OpenSSL parsing fails.
|
|
|
|
---
|
|
|
|
### `checkCompatibility(array|string $data, bool $allowHEVC = false): bool`
|
|
|
|
Checks whether media codecs are compatible with player constraints.
|
|
Accepts FFProbe payload as array or JSON string.
|
|
|
|
Default accepted codecs include:
|
|
|
|
- video: `h264`, `vp8`, `vp9`, `ogg`, `av1`
|
|
- audio: `aac`, `libfdk_aac`, `opus`, `vorbis`, `pcm_s16le`, `mp2`, `mp3`, `flac`
|
|
|
|
With `$allowHEVC=true`, allows `hevc`/`h265` and `ac3`.
|
|
|
|
---
|
|
|
|
### `downloadPanelLogs(object $db): array`
|
|
|
|
Fetches up to 1000 recent rows from `panel_logs` (excluding `epg`), sanitizes output fields, and clears log rows after export.
|
|
|
|
Return shape:
|
|
|
|
```php
|
|
[
|
|
'errors' => [...],
|
|
'version' => '...'
|
|
]
|
|
```
|
|
|
|
Throws `Exception` on DB query failure.
|
|
|
|
---
|
|
|
|
### `submitPanelLogs(object $db): string|false`
|
|
|
|
Submits panel logs to remote diagnostics endpoint and clears submitted logs.
|
|
Returns the response string on success, `false` on failure (e.g. API IP resolution fails).
|
|
Used for support/telemetry workflows.
|
|
|
|
---
|
|
|
|
## `panel_logs` Shape (used fields)
|
|
|
|
| Column | Type | Meaning |
|
|
| --- | --- | --- |
|
|
| `type` | string | event type |
|
|
| `log_message` | string | main message |
|
|
| `log_extra` | string | extra context |
|
|
| `line` | int | source line |
|
|
| `date` | int | UNIX timestamp |
|
|
|
|
---
|
|
|
|
### `getPIDs(int $rServerID): array`
|
|
|
|
Parses system process information from server API response. Returns structured process data for monitoring.
|
|
|
|
---
|
|
|
|
### `getNVENCProcesses(int $rServerID): array`
|
|
|
|
Extracts GPU (NVENC) process data from server GPU info. Used for GPU encoding diagnostics.
|
|
|
|
---
|
|
|
|
## Related files
|
|
|
|
| File | Purpose |
|
|
| --- | --- |
|
|
| `src/Core/Diagnostics/DiagnosticsService.php` | diagnostics methods |
|
|
| `src/Core/Logging/Logger.php` | writes logs |
|
|
| `src/Core/Config/ConstantsInitializer.php` | version metadata (`appConfig()` map) |
|