event_logs
Creates, updates, deletes, gets or lists an event_logs resource.
Overview
| Name | event_logs |
| Type | Resource |
| Id | digitalocean.apps.event_logs |
Fields
The following fields are returned by SELECT queries:
- apps_get_event_logs
A JSON object with urls that point to archived logs
| Name | Datatype | Description |
|---|---|---|
historic_urls | array | (title: A list of URLs to archived log files) |
live_url | string | A URL of the real-time live logs. This URL may use either the https:// or wss:// protocols and will keep pushing live logs as they become available. (example: ws://logs/build) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
apps_get_event_logs | select | app_id, event_id, type | follow, pod_connection_timeout | Retrieve the logs of an autoscaling event for an app. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
app_id | string | The app ID (example: 4f6c71e2-1e90-4762-9fee-6cc4a0a9f2cf) |
event_id | string | The event ID (example: 4f6c71e2-1e90-4762-9fee-6cc4a0a9f2cf) |
type | string | The type of logs to retrieve - BUILD: Build-time logs - DEPLOY: Deploy-time logs - RUN: Live run-time logs - RUN_RESTARTED: Logs of crashed/restarted instances during runtime - AUTOSCALE_EVENT: Logs of an autoscaling event (requires event_id) (example: BUILD) |
follow | boolean | Whether the logs should follow live updates. (example: true) |
pod_connection_timeout | string | An optional time duration to wait if the underlying component instance is not immediately available. Default: 3m. (example: 3m) |
SELECT examples
- apps_get_event_logs
Retrieve the logs of an autoscaling event for an app.
SELECT
historic_urls,
live_url
FROM digitalocean.apps.event_logs
WHERE app_id = '{{ app_id }}' -- required
AND event_id = '{{ event_id }}' -- required
AND type = '{{ type }}' -- required
AND follow = '{{ follow }}'
AND pod_connection_timeout = '{{ pod_connection_timeout }}'
;