nrdb_events: Retrieve a contiguous chunk of raw events.

In bkayser/NewRelicR: Interface for New Relic Application Data

Description

This returns a set of events making a best effort to get a contguous chunk. So if you give a limit of 5000 events it will make successive queries staying under the limit of 1000 until it has all 5000 events. You are guaranteed no duplicates but not guaranteed you won't miss some events if they are sparse or bursty.

Usage

nrdb_events(account_id, api_key, app_id = NULL, attrs = "*", where = NULL,
  start_time = Sys.time() - lubridate::dminutes(60), end_time = Sys.time(),
  limit = 1000, event_type = "Transaction", verbose = F, timeout = 1000,
  sampling_rate = NULL)

Arguments

account_id	your New Relic account ID
api_key	your New Relic NRDB (Insights) API key
app_id	the application with the transactions, required unless a where clause is provided
attrs	an optional array of attributes to fetch; default is everything (*)
where	a clause to use to qualify the events fetched; must specify either app_id or where
start_time	the timestamp where to start looking
end_time	the end bounds of the timerange
limit	the number of events to retrieve
event_type	the given transaction type; default is 'Transaction'
verbose	for detailed logging
timeout	value in ms to wait for a response
sampling_rate	the rate of events to use, if sampling. Value between 0 and 1

Details

There are a lot of transient errors in the NRDB api. If an error occurs getting a chunk, it will retry 3 times and then give up.

Value

a dataframe with limit rows and the union of all attributes in all sampled events.

bkayser/NewRelicR documentation built on May 12, 2019, 9:27 p.m.