Setting DSC parameters to share
How it works
Automic provides a DCS feature that enables you to share your data with us. This feature can be easily added using the Analytics Action Pack from the market place.
Note if you install AE with One Installer the Analytics Action Pack is included.
For further information regarding installing and upgrading Action Packs refer to : Working with Packs
Getting Started
The DCS feature is used to extract data on site and helps you transfer that data to Automic for analysis. The installed Action Pack can be found by going to the AWI explorer and then to PACKAGES>PCK.AUTOMIC_ANALYTICS > Actions > DCS.
The following table outlines what DCS object type you'll find in the AWI explorer, it location and it's purpose:
| DCS item | Object Type | Location in AWI Explorer | Purpose |
|---|---|---|---|
| PCK.AUTOMIC_ANALYTICS.PUB.DCS.SETTINGS | VARA | PACKAGES>APPDATA>PCK.AUTOMIC_ANALYTICS | Configuration of data transfer variables |
| PCK.AUTOMIC_ANALYTICS.PUB.ACTION.TRANSFER_COLLECTED_DATA_TO_AUTOMIC. | Job | PACKAGES>PCK.AUTOMIC_ANALYTICS >DCS | Launches the data transfer job and automatically transfers data to Liquid file server. |
| PCK.AUTOMIC_ANALYTICS.PRV.STORE.TELEMETRY_TOOLS | Store | PACKAGES>PCK.AUTOMIC_ANALYTICS >RESOURCES | Installed binary |
Step 1: Customizing transfer DCS variables
DCS settings can be customized by clicking on the VARA object: PCK.AUTOMIC_ANALYTICS.PUB.DCS.SETTINGS
Items that can be customized include: Location of logs, the liquid file server, email sender and the export file size.
In the vast majority of cases you will not have to edit these settings, however if for example the liquid file server has changed or you want to control the size of your export data you have the option to make changes via these settings.
The following table below describes customizable options:
| Variable Name | Default Value | Description |
|---|---|---|
| DATAEXPORT_CONSUMER_ID | telemetry-data-consumer | Kafka consumer ID |
| DATAEXPORT_EXPORTLOG_ENABLED | 1 | Enable / disable creation of export log file |
| DATAEXPORT_EXPORTLOG_FOLDER | dataexportlog | Path to exportlog file |
| DATAEXPORT_FILESIZE_LIMIT_MB | 50 | Limit exported file size in mega bytes |
| DATAEXPORT_OUTPUT_FOLDER | data/output | Path to exported avro files |
| DATASEND_ARCHIVE_ENABLED | 1 | Enable / disable archiving of avro files after they are sent |
| DATASEND_ARCHIVE_FOLDER | data/archive | Path to archived avro files |
| DATASHARE_ARCHIVE_KEEP_DAYS | 1 | Number of days to keep archived files |
| DATASHARE_EXPORT_ENABLED | 1 | Enable / disable data export |
| DATASHARE_EXPORT_KEEP_DAYS | 3 | Number of days to keep exported data files |
| DATASHARE_SEND_ENABLED | 1 | Enable / disable data sent to automic |
| LIQUIDFILES_BASE_URL | https://ft.automic.com | LiquidFiles base URL (do not modify) |
| LIQUIDFILES_FILEDROP | telemetry@automic.com | LiquidFiles target filedrop ID |
| LIQUIDFILES_MESSAGE | Analytics Data | LiquidFiles message content |
| LIQUIDFILES_SENDER | customer@domain.com | LiquidFiles message sender email |
| LIQUIDFILES_SUBJECT | LiquidFiles message subject | Analytics Data |
| Timeout Tuning | Default Value (ms) | Description |
|---|---|---|
| TIMEOUT_DCS_CONNECT | 10000 | Analytics server connection timeout in ms |
| TIMEOUT_DCS_SOCKET | 30000 | Analytics server socket timeout in ms |
| TIMEOUT_LIQUIDFILES_CONNECT | 10000 | Remote Automic server connection timeout in ms |
| TIMEOUT_LIQUIDFILES_READWRITE | 30000 | Remote Automic server read / write timeout in ms |
Other VARA objects in the folder are for:
- Backups
- Configuration for DCS actions