Skip to main content

log_entries

Creates, updates, deletes, gets or lists a log_entries resource.

Overview

Namelog_entries
TypeResource
Idpagerduty.incidents.log_entries

Fields

The following fields are returned by SELECT queries:

A paginated array of the incident's log entries.

NameDatatypeDescription

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectidlimit, offset, total, time_zone, since, until, is_overview, include[]List log entries for the specified incident.<br /><br />An incident represents a problem or an issue that needs to be addressed and resolved.<br /><br />A Log Entry are a record of all events on your account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#incidents)<br /><br />Scoped OAuth requires: incidents.read<br />

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.

NameDatatypeDescription
idstringThe ID of the resource.
include[]stringArray of additional Models to include in response.
is_overviewbooleanIf true, will return a subset of log entries that show only the most important changes to the incident.
limitintegerThe number of results per page.
offsetintegerOffset to start pagination search results.
sincestring (date-time)The start of the date range over which you want to search.
time_zonestring (tzinfo)Time zone in which results will be rendered. This will default to the account time zone.
totalbooleanBy default the total field in pagination responses is set to null to provide the fastest possible response times. Set total to true for this field to be populated. See our [Pagination Docs](https:​//developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information.
untilstring (date-time)The end of the date range over which you want to search.

SELECT examples

List log entries for the specified incident.<br /><br />An incident represents a problem or an issue that needs to be addressed and resolved.<br /><br />A Log Entry are a record of all events on your account.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#incidents)<br /><br />Scoped OAuth requires: incidents.read<br />

SELECT
*
FROM pagerduty.incidents.log_entries
WHERE id = '{{ id }}' -- required
AND limit = '{{ limit }}'
AND offset = '{{ offset }}'
AND total = '{{ total }}'
AND time_zone = '{{ time_zone }}'
AND since = '{{ since }}'
AND until = '{{ until }}'
AND is_overview = '{{ is_overview }}'
AND include[] = '{{ include[] }}'
;