Resource: EntityType
An entity type is a type of object in a system that needs to be modeled and have stored information about. For example, driver is an entity type, and driver0 is an instance of an entity type driver.
name
string
Immutable. name of the EntityType. Format: projects/{project}/locations/{location}/featurestores/{featurestore}/entityTypes/{entityType}
The last part entityType is assigned by the client. The entityType can be up to 64 characters long and can consist only of ASCII Latin letters A-Z and a-z and underscore(_), and ASCII digits 0-9 starting with a letter. The value will be unique given a featurestore.
description
string
Optional. description of the EntityType.
createTime
string (Timestamp
format)
Output only. timestamp when this EntityType was created.
A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z"
and "2014-10-02T15:01:23.045123456Z"
.
updateTime
string (Timestamp
format)
Output only. timestamp when this EntityType was most recently updated.
A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z"
and "2014-10-02T15:01:23.045123456Z"
.
labels
map (key: string, value: string)
Optional. The labels with user-defined metadata to organize your EntityTypes.
label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.
See https://goo.gl/xmQnxf for more information on and examples of labels. No more than 64 user labels can be associated with one EntityType (System labels are excluded)." System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable.
etag
string
Optional. Used to perform a consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
monitoringConfig
object (FeaturestoreMonitoringConfig
)
Optional. The default monitoring configuration for all Features with value type (feature.ValueType
) BOOL, STRING, DOUBLE or INT64 under this EntityType.
If this is populated with [FeaturestoreMonitoringConfig.monitoring_interval] specified, snapshot analysis monitoring is enabled. Otherwise, snapshot analysis monitoring is disabled.
offlineStorageTtlDays
integer
Optional. Config for data retention policy in offline storage. TTL in days for feature values that will be stored in offline storage. The feature Store offline storage periodically removes obsolete feature values older than offlineStorageTtlDays
since the feature generation time. If unset (or explicitly set to 0), default to 4000 days TTL.
satisfiesPzs
boolean
Output only. reserved for future use.
satisfiesPzi
boolean
Output only. reserved for future use.
JSON representation |
---|
{
"name": string,
"description": string,
"createTime": string,
"updateTime": string,
"labels": {
string: string,
...
},
"etag": string,
"monitoringConfig": {
object ( |
FeaturestoreMonitoringConfig
Configuration of how features in Featurestore are monitored.
snapshotAnalysis
object (SnapshotAnalysis
)
The config for Snapshot Analysis Based feature Monitoring.
importFeaturesAnalysis
object (ImportFeaturesAnalysis
)
The config for ImportFeatures Analysis Based feature Monitoring.
numericalThresholdConfig
object (ThresholdConfig
)
Threshold for numerical features of anomaly detection. This is shared by all objectives of Featurestore Monitoring for numerical features (i.e. Features with type (feature.ValueType
) DOUBLE or INT64).
categoricalThresholdConfig
object (ThresholdConfig
)
Threshold for categorical features of anomaly detection. This is shared by all types of Featurestore Monitoring for categorical features (i.e. Features with type (feature.ValueType
) BOOL or STRING).
JSON representation |
---|
{ "snapshotAnalysis": { object ( |
SnapshotAnalysis
Configuration of the Featurestore's Snapshot Analysis Based Monitoring. This type of analysis generates statistics for each feature based on a snapshot of the latest feature value of each entities every monitoringInterval.
disabled
boolean
The monitoring schedule for snapshot analysis. For EntityType-level config: unset / disabled = true indicates disabled by default for Features under it; otherwise by default enable snapshot analysis monitoring with monitoringInterval for Features under it. feature-level config: disabled = true indicates disabled regardless of the EntityType-level config; unset monitoringInterval indicates going with EntityType-level config; otherwise run snapshot analysis monitoring with monitoringInterval regardless of the EntityType-level config. Explicitly Disable the snapshot analysis based monitoring.
monitoringIntervalDays
integer
Configuration of the snapshot analysis based monitoring pipeline running interval. The value indicates number of days.
stalenessDays
integer
Customized export features time window for snapshot analysis. Unit is one day. Default value is 3 weeks. Minimum value is 1 day. Maximum value is 4000 days.
JSON representation |
---|
{ "disabled": boolean, "monitoringIntervalDays": integer, "stalenessDays": integer } |
ImportFeaturesAnalysis
Configuration of the Featurestore's ImportFeature Analysis Based Monitoring. This type of analysis generates statistics for values of each feature imported by every entityTypes.importFeatureValues
operation.
state
enum (State
)
Whether to enable / disable / inherite default hebavior for import features analysis.
anomalyDetectionBaseline
enum (Baseline
)
The baseline used to do anomaly detection for the statistics generated by import features analysis.
State
The state defines whether to enable ImportFeature analysis.
Enums | |
---|---|
STATE_UNSPECIFIED |
Should not be used. |
DEFAULT |
The default behavior of whether to enable the monitoring. EntityType-level config: disabled. feature-level config: inherited from the configuration of EntityType this feature belongs to. |
ENABLED |
Explicitly enables import features analysis. EntityType-level config: by default enables import features analysis for all Features under it. feature-level config: enables import features analysis regardless of the EntityType-level config. |
DISABLED |
Explicitly disables import features analysis. EntityType-level config: by default disables import features analysis for all Features under it. feature-level config: disables import features analysis regardless of the EntityType-level config. |
Baseline
Defines the baseline to do anomaly detection for feature values imported by each entityTypes.importFeatureValues
operation.
Enums | |
---|---|
BASELINE_UNSPECIFIED |
Should not be used. |
LATEST_STATS |
Choose the later one statistics generated by either most recent snapshot analysis or previous import features analysis. If non of them exists, skip anomaly detection and only generate a statistics. |
MOST_RECENT_SNAPSHOT_STATS |
Use the statistics generated by the most recent snapshot analysis if exists. |
PREVIOUS_IMPORT_FEATURES_STATS |
Use the statistics generated by the previous import features analysis if exists. |
ThresholdConfig
The config for Featurestore Monitoring threshold.
Union field threshold
.
threshold
can be only one of the following:
value
number
Specify a threshold value that can trigger the alert. 1. For categorical feature, the distribution distance is calculated by L-inifinity norm. 2. For numerical feature, the distribution distance is calculated by Jensen–Shannon divergence. Each feature must have a non-zero threshold if they need to be monitored. Otherwise no alert will be triggered for that feature.
JSON representation |
---|
{ // Union field |
Methods |
|
---|---|
|
Creates a new EntityType in a given Featurestore. |
|
Deletes a single EntityType. |
|
Delete Feature values from Featurestore. |
|
Exports Feature values from all the entities of a target EntityType. |
|
Gets details of a single EntityType. |
|
Gets the access control policy for a resource. |
|
Imports Feature values into the Featurestore from a source storage. |
|
Lists EntityTypes in a given Featurestore. |
|
Updates the parameters of a single EntityType. |
|
Reads Feature values of a specific entity of an EntityType. |
|
Sets the access control policy on the specified resource. |
|
Reads Feature values for multiple entities. |
|
Returns permissions that a caller has on the specified resource. |
|
Writes Feature values of one or more entities of an EntityType. |