DataCollection

更新时间:
复制 MD 格式

The DataCollection object represents a data collection task in an OpenSearch application. Data collection captures user behavior and item information from your application, enabling OpenSearch to deliver personalized search results and analytics.

Example

{
    "id": "286",
    "name": "os_function_test_v1",
    "type": "server",
    "status": 2,
    "dataCollectionType": "BEHAVIOR",
    "industryName": "GENERAL",
    "created": 1581065837,
    "updated": 1581065904,
    "sundialId": "1755"
}

In this example, status: 2 means the data collection feature is enabled, and dataCollectionType: "BEHAVIOR" means the task collects behavioral data.

Fields

FieldTypeDescription
idStringThe ID of the data collection task.
nameStringThe name of the data collection task.
typeStringThe source type from which data is collected. Valid values: server, web, app. Note: Only server is supported.
statusIntegerThe status of the data collection feature. See Status values.
dataCollectionTypeStringThe type of data to collect. Valid values: BEHAVIOR, item_info, industry-specific.
industryNameStringThe industry type. Valid values: GENERAL, ecommerce.
sundialIdStringThe ID of the internal sundial scheduling system.
createdIntegerThe time when the data collection task was created.
updatedIntegerThe time when the data collection task was last updated.

Status values

The status field reflects the lifecycle of a data collection task:

ValueMeaningDescription
0Not enabledThe data collection feature has not been enabled.
1EnablingThe feature is being enabled. This is a transitional state.
2EnabledThe feature is active and collecting data.
3FailedThe feature failed to enable. Check your configuration and try again.

Normal flow: 0 (not enabled) → 1 (enabling) → 2 (enabled)

Error path: 013 (failed)

Data collection types

The dataCollectionType field determines what kind of data the task collects:

ValueDescription
BEHAVIORBehavioral data.
item_infoItem information.
industry-specificIndustry-specific information tailored to the selected industry.