Scheduled exporting operations perform historical data and forecast export to a local file system in CSV or Excel formats, as well as the delivery of produced reports to email subscribers.
Scheduled Exporting Settings
Control scheduled export operations via
cron expression. See Scheduling for example and instructions about scheduling export jobs.
Concurrent executions for the same job are not allowed.
Export job settings are located in
export.worker.count (default = 8): Number of simultaneously executable export jobs.
export.worker.queue (default = 8): Number of export jobs that can be queued for execution.
If a new job is queued for execution while the queue is already full, the job is rejected.
Export Job Logging
Each export job execution is logged in ATSD. Messages are saved to track the status. Logging parameters are enumerated below.
The administrator can create rules to notify if a job is not executed according to schedule.
entity=atsd common tags:
|Event||Status||Severity||Name||Message||Start Time||End Time|
|Job start|| || || || || |
|Job complete|| || || || || |
|Job queued|| || || || || |
|Job blocked || || || || || |
|Job rejected|| || || || || |
|Job failed|| || || || || |
*Raised when a job starts while the previous instance of the same job is still running.
|Name||Export job name.|
|Data Type||Type of data exported.|
|Metric||Metric name for which data is exported.|
Data is exported for one metric at a time.
|Entity||If selected, exported data is limited to the specified entity.|
Supersedes the Entity Group field.
|Entity Group||If selected, exported data is limited to entities contained in the specified entity group.|
Supersedes Entity Expression field.
|Entity Expression||An expression to filter selected data by entity name and entity tags.|
|Value Filter||Expression defines a condition for which to check when fetching detailed samples.|
Value Filter is applied before aggregation and therefore impacts aggregated statistics values.
To filter deleted values, use
|Selection Interval||Time period of exported data.|
Optionally define the end of this period in the End Time field.
The default value is current time.
The Selection Interval setting is ignored if both the Start Time and End Time fields are set.
|Start Time||Start time of the selection interval.|
This field supports calendar keywords, for example
If not defined, Start Time is calculated as End Time minus Selection Interval.
|End Time||End time of the selection interval.|
This field supports calendar keywords, for example
If not defined, End Time is calculated as Start Time plus Selection Interval.
If Start Time is not defined, End Time is set to current time.
|Versioning||Display value history for metrics with enabled Versioning.|
Versioning is displayed only for detailed, non-aggregated samples.
|Revisions Only||Filters samples by versions with value changes.|
Excludes samples without versions.
|Version Filter||Expression to filter value history (versions) by version value, status, source, or time.|
To filter by version time, use the
|Aggregate||Enable period aggregations based on selected detailed samples, after the optional Value Filter is applied.|
|Aggregation Period||Period of time over which detailed samples are aggregated.|
|Interpolation||Insert missing periods in aggregated results.|
The period is considered missing if it contains no detailed samples.
|Aggregate Statistics||One or multiple aggregation functions: average, minimum, maximum, sum, count, standard deviation, weighted average, weighted time average, median (percentile 50), first, last, percentile 50/75/90/95/99/99.5/99.9, |
|Format||Export file format.|
|Compression||Compression of exported files.|
|Output Path||Absolute path for exported files.|
Expressions can be used to create timestamped files.
This means that exported files are grouped by month and year, each in their relevant directory.
|Split by Entity||Creates a new file for each exported entity, which is helpful when exporting data for multiple entities.|
If Output Path contains
If Output Path does not contain
|Annotation||Custom annotation that is added above the exported time series.|
Can include any text, characters, and numbers.
If the field is left empty, no custom annotation is added.
To include entity name, entity tags, metric names, or metric tags use the following placeholders as part of the annotation text:
|Entity Tags||List of entity tags included as columns in the exported file.|
|Metric Tags||List of metric tags included as columns in the exported file.|
|Decimal Precision||Number of fractional digits displayed. If a negative value such as -1 is specified, stored numbers are displayed without any formatting.|
|Time Format||Format for displaying series sample timestamps: Local Time (server time zone) or ISO format (UTC time).|
|Email Subscribers||List of email addresses separated by commas, white spaces, or semi-colons, to which the exported files are sent as attachments.|
|Email Subject||Email subject.|
Clicking Test exports the first file, displays the file name, and provides a link to download the file.