nrdb_events: Retrieve a contiguous chunk of raw events.

Description Usage Arguments Details Value

View source: R/nrdb_api.R

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

1
2
3
4
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 April 27, 2018, 8:32 p.m.