public static final class Collection.Builder extends GeneratedMessage.Builder<Collection.Builder> implements CollectionOrBuilderCollection represents a container of objects (such as events, entity context metadata, detection finding metadata) and state (such as investigation details).
An example use case for Collection is to model a detection and investigation from detection finding metadata to investigative state collected in the course of the investigation. For more complex investigation and response workflows a Collection could represent an incident consisting of multiple child findings or incidents. This can be expanded on to model remediation elements of a full detection and response workflow.
Protobuf type google.backstory.Collection
Inheritance
java.lang.Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessage.Builder > Collection.BuilderImplements
CollectionOrBuilderStatic Methods
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()| Returns | |
|---|---|
| Type | Description |
Descriptor |
|
Methods
addAllCollectionElements(Iterable<? extends Element> values)
public Collection.Builder addAllCollectionElements(Iterable<? extends Element> values)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameter | |
|---|---|
| Name | Description |
values |
Iterable<? extends com.google.backstory.Element> |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
addAllDetection(Iterable<? extends SecurityResult> values)
public Collection.Builder addAllDetection(Iterable<? extends SecurityResult> values)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameter | |
|---|---|
| Name | Description |
values |
Iterable<? extends com.google.backstory.SecurityResult> |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
addAllDetectionTimingDetails(Iterable<? extends Collection.DetectionTimingDetails> values)
public Collection.Builder addAllDetectionTimingDetails(Iterable<? extends Collection.DetectionTimingDetails> values)Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Parameter | |
|---|---|
| Name | Description |
values |
Iterable<? extends com.google.backstory.Collection.DetectionTimingDetails>The detectionTimingDetails to add. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
addAllDetectionTimingDetailsValue(Iterable<Integer> values)
public Collection.Builder addAllDetectionTimingDetailsValue(Iterable<Integer> values)Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Parameter | |
|---|---|
| Name | Description |
values |
Iterable<Integer>The enum numeric values on the wire for detectionTimingDetails to add. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
addAllSimulatedEventNames(Iterable<String> values)
public Collection.Builder addAllSimulatedEventNames(Iterable<String> values)The set of all values from event ingestion_labels where SIMULATED is set as the key, for all simulated events that participated in this detection.
repeated string simulated_event_names = 24;
| Parameter | |
|---|---|
| Name | Description |
values |
Iterable<String>The simulatedEventNames to add. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
addAllTags(Iterable<String> values)
public Collection.Builder addAllTags(Iterable<String> values)Tags set by UC/DSML/RE for the Finding during creation.
repeated string tags = 11;
| Parameter | |
|---|---|
| Name | Description |
values |
Iterable<String>The tags to add. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
addCollectionElements(Element value)
public Collection.Builder addCollectionElements(Element value)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameter | |
|---|---|
| Name | Description |
value |
Element |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
addCollectionElements(Element.Builder builderForValue)
public Collection.Builder addCollectionElements(Element.Builder builderForValue)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
Element.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
addCollectionElements(int index, Element value)
public Collection.Builder addCollectionElements(int index, Element value)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
value |
Element |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
addCollectionElements(int index, Element.Builder builderForValue)
public Collection.Builder addCollectionElements(int index, Element.Builder builderForValue)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
builderForValue |
Element.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
addCollectionElementsBuilder()
public Element.Builder addCollectionElementsBuilder()Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Returns | |
|---|---|
| Type | Description |
Element.Builder |
|
addCollectionElementsBuilder(int index)
public Element.Builder addCollectionElementsBuilder(int index)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
Element.Builder |
|
addDetection(SecurityResult value)
public Collection.Builder addDetection(SecurityResult value)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameter | |
|---|---|
| Name | Description |
value |
SecurityResult |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
addDetection(SecurityResult.Builder builderForValue)
public Collection.Builder addDetection(SecurityResult.Builder builderForValue)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
SecurityResult.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
addDetection(int index, SecurityResult value)
public Collection.Builder addDetection(int index, SecurityResult value)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
value |
SecurityResult |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
addDetection(int index, SecurityResult.Builder builderForValue)
public Collection.Builder addDetection(int index, SecurityResult.Builder builderForValue)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
builderForValue |
SecurityResult.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
addDetectionBuilder()
public SecurityResult.Builder addDetectionBuilder()Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Returns | |
|---|---|
| Type | Description |
SecurityResult.Builder |
|
addDetectionBuilder(int index)
public SecurityResult.Builder addDetectionBuilder(int index)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
SecurityResult.Builder |
|
addDetectionTimingDetails(Collection.DetectionTimingDetails value)
public Collection.Builder addDetectionTimingDetails(Collection.DetectionTimingDetails value)Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Parameter | |
|---|---|
| Name | Description |
value |
Collection.DetectionTimingDetailsThe detectionTimingDetails to add. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
addDetectionTimingDetailsValue(int value)
public Collection.Builder addDetectionTimingDetailsValue(int value)Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Parameter | |
|---|---|
| Name | Description |
value |
intThe enum numeric value on the wire for detectionTimingDetails to add. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
addSimulatedEventNames(String value)
public Collection.Builder addSimulatedEventNames(String value)The set of all values from event ingestion_labels where SIMULATED is set as the key, for all simulated events that participated in this detection.
repeated string simulated_event_names = 24;
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe simulatedEventNames to add. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
addSimulatedEventNamesBytes(ByteString value)
public Collection.Builder addSimulatedEventNamesBytes(ByteString value)The set of all values from event ingestion_labels where SIMULATED is set as the key, for all simulated events that participated in this detection.
repeated string simulated_event_names = 24;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes of the simulatedEventNames to add. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
addTags(String value)
public Collection.Builder addTags(String value)Tags set by UC/DSML/RE for the Finding during creation.
repeated string tags = 11;
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe tags to add. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
addTagsBytes(ByteString value)
public Collection.Builder addTagsBytes(ByteString value)Tags set by UC/DSML/RE for the Finding during creation.
repeated string tags = 11;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes of the tags to add. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
build()
public Collection build()| Returns | |
|---|---|
| Type | Description |
Collection |
|
buildPartial()
public Collection buildPartial()| Returns | |
|---|---|
| Type | Description |
Collection |
|
clear()
public Collection.Builder clear()| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearCaseName()
public Collection.Builder clearCaseName()The resource name of the Case that this collection belongs to. Example: projects/{project id}/locations/{region}/chronicle/cases/{internal_case_id}
string case_name = 14;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
clearCollectionElements()
public Collection.Builder clearCollectionElements()Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearCreatedTime()
public Collection.Builder clearCreatedTime()Time the collection was created.
.google.protobuf.Timestamp created_time = 5;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearDataAccessScope()
public Collection.Builder clearDataAccessScope()The resource name of the DataAccessScope of this collection.
string data_access_scope = 19;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
clearDetection()
public Collection.Builder clearDetection()Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearDetectionTime()
public Collection.Builder clearDetectionTime()Timestamp within the time_window related to the time of the collection_elements. For Rule Detections, this timestamp is the end of the the time_window for multi-event rules or the time of the event for single event rules. For late-arriving events that trigger new alerts, the detection_time will be the event time of the event.
.google.protobuf.Timestamp detection_time = 10;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearDetectionTimingDetails()
public Collection.Builder clearDetectionTimingDetails()Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
clearId()
public Collection.Builder clearId()Unique ID for the collection. The ID is specific to the type of collection. For example, with rule detections this is the detection ID.
string id = 7;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
clearIdNamespace()
public Collection.Builder clearIdNamespace()The ID namespace used for the Collection.
.google.backstory.Id.Namespace id_namespace = 12;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
clearInvestigation()
public Collection.Builder clearInvestigation()Consolidated investigation details (categorization, status, etc) typically for collections that begin as detection findings and then evolve with analyst action and feedback into investigations around the detection output.
.google.backstory.Investigation investigation = 4;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearLastUpdatedTime()
public Collection.Builder clearLastUpdatedTime()Time the collection was last updated.
.google.protobuf.Timestamp last_updated_time = 6;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearLatencyMetrics()
public Collection.Builder clearLatencyMetrics()The latency metrics for the specific detection. These metrics are calculated from ALL of the events that contribute to the detection, not just the sampled ones.
.google.backstory.LatencyMetrics latency_metrics = 21;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearResponsePlatformInfo()
public Collection.Builder clearResponsePlatformInfo()Alert related info of this same alert in customer's SOAR platform.
.google.backstory.ResponsePlatformInfo response_platform_info = 13;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearRuleRunFrequency()
public Collection.Builder clearRuleRunFrequency()The run frequency of the rule when it generated the detection.
.google.backstory.Collection.RunFrequency rule_run_frequency = 22;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
clearSimulatedEventCount()
public Collection.Builder clearSimulatedEventCount()The total number of simulated events that contributed to this detection. Simulated events are realistic threat sequences (Raw Logs or UDM) programmatically delivered into the production ingestion pipeline to verify the entire detection lifecycle—from identification to action.
int64 simulated_event_count = 23;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
clearSimulatedEventNames()
public Collection.Builder clearSimulatedEventNames()The set of all values from event ingestion_labels where SIMULATED is set as the key, for all simulated events that participated in this detection.
repeated string simulated_event_names = 24;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
clearSoarAlert()
public Collection.Builder clearSoarAlert()A boolean field indicating that the alert is present in SOAR.
bool soar_alert = 17;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
clearSoarAlertMetadata()
public Collection.Builder clearSoarAlertMetadata()Metadata fields of alerts coming from other SIEM systems via SOAR.
.google.backstory.SoarAlertMetadata soar_alert_metadata = 18;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearTags()
public Collection.Builder clearTags()Tags set by UC/DSML/RE for the Finding during creation.
repeated string tags = 11;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
clearTimeWindow()
public Collection.Builder clearTimeWindow()Time interval that the collection represents.
.google.type.Interval time_window = 8;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
clearType()
public Collection.Builder clearType()What the collection represents.
.google.backstory.Collection.CollectionType type = 1;
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
getCaseName()
public String getCaseName()The resource name of the Case that this collection belongs to. Example: projects/{project id}/locations/{region}/chronicle/cases/{internal_case_id}
string case_name = 14;
| Returns | |
|---|---|
| Type | Description |
String |
The caseName. |
getCaseNameBytes()
public ByteString getCaseNameBytes()The resource name of the Case that this collection belongs to. Example: projects/{project id}/locations/{region}/chronicle/cases/{internal_case_id}
string case_name = 14;
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes for caseName. |
getCollectionElements(int index)
public Element getCollectionElements(int index)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
Element |
|
getCollectionElementsBuilder(int index)
public Element.Builder getCollectionElementsBuilder(int index)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
Element.Builder |
|
getCollectionElementsBuilderList()
public List<Element.Builder> getCollectionElementsBuilderList()Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Returns | |
|---|---|
| Type | Description |
List<Builder> |
|
getCollectionElementsCount()
public int getCollectionElementsCount()Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Returns | |
|---|---|
| Type | Description |
int |
|
getCollectionElementsList()
public List<Element> getCollectionElementsList()Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Returns | |
|---|---|
| Type | Description |
List<Element> |
|
getCollectionElementsOrBuilder(int index)
public ElementOrBuilder getCollectionElementsOrBuilder(int index)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
ElementOrBuilder |
|
getCollectionElementsOrBuilderList()
public List<? extends ElementOrBuilder> getCollectionElementsOrBuilderList()Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Returns | |
|---|---|
| Type | Description |
List<? extends com.google.backstory.ElementOrBuilder> |
|
getCreatedTime()
public Timestamp getCreatedTime()Time the collection was created.
.google.protobuf.Timestamp created_time = 5;
| Returns | |
|---|---|
| Type | Description |
Timestamp |
The createdTime. |
getCreatedTimeBuilder()
public Timestamp.Builder getCreatedTimeBuilder()Time the collection was created.
.google.protobuf.Timestamp created_time = 5;
| Returns | |
|---|---|
| Type | Description |
Builder |
|
getCreatedTimeOrBuilder()
public TimestampOrBuilder getCreatedTimeOrBuilder()Time the collection was created.
.google.protobuf.Timestamp created_time = 5;
| Returns | |
|---|---|
| Type | Description |
TimestampOrBuilder |
|
getDataAccessScope()
public String getDataAccessScope()The resource name of the DataAccessScope of this collection.
string data_access_scope = 19;
| Returns | |
|---|---|
| Type | Description |
String |
The dataAccessScope. |
getDataAccessScopeBytes()
public ByteString getDataAccessScopeBytes()The resource name of the DataAccessScope of this collection.
string data_access_scope = 19;
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes for dataAccessScope. |
getDefaultInstanceForType()
public Collection getDefaultInstanceForType()| Returns | |
|---|---|
| Type | Description |
Collection |
|
getDescriptorForType()
public Descriptors.Descriptor getDescriptorForType()| Returns | |
|---|---|
| Type | Description |
Descriptor |
|
getDetection(int index)
public SecurityResult getDetection(int index)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
SecurityResult |
|
getDetectionBuilder(int index)
public SecurityResult.Builder getDetectionBuilder(int index)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
SecurityResult.Builder |
|
getDetectionBuilderList()
public List<SecurityResult.Builder> getDetectionBuilderList()Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Returns | |
|---|---|
| Type | Description |
List<Builder> |
|
getDetectionCount()
public int getDetectionCount()Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Returns | |
|---|---|
| Type | Description |
int |
|
getDetectionList()
public List<SecurityResult> getDetectionList()Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Returns | |
|---|---|
| Type | Description |
List<SecurityResult> |
|
getDetectionOrBuilder(int index)
public SecurityResultOrBuilder getDetectionOrBuilder(int index)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
SecurityResultOrBuilder |
|
getDetectionOrBuilderList()
public List<? extends SecurityResultOrBuilder> getDetectionOrBuilderList()Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Returns | |
|---|---|
| Type | Description |
List<? extends com.google.backstory.SecurityResultOrBuilder> |
|
getDetectionTime()
public Timestamp getDetectionTime()Timestamp within the time_window related to the time of the collection_elements. For Rule Detections, this timestamp is the end of the the time_window for multi-event rules or the time of the event for single event rules. For late-arriving events that trigger new alerts, the detection_time will be the event time of the event.
.google.protobuf.Timestamp detection_time = 10;
| Returns | |
|---|---|
| Type | Description |
Timestamp |
The detectionTime. |
getDetectionTimeBuilder()
public Timestamp.Builder getDetectionTimeBuilder()Timestamp within the time_window related to the time of the collection_elements. For Rule Detections, this timestamp is the end of the the time_window for multi-event rules or the time of the event for single event rules. For late-arriving events that trigger new alerts, the detection_time will be the event time of the event.
.google.protobuf.Timestamp detection_time = 10;
| Returns | |
|---|---|
| Type | Description |
Builder |
|
getDetectionTimeOrBuilder()
public TimestampOrBuilder getDetectionTimeOrBuilder()Timestamp within the time_window related to the time of the collection_elements. For Rule Detections, this timestamp is the end of the the time_window for multi-event rules or the time of the event for single event rules. For late-arriving events that trigger new alerts, the detection_time will be the event time of the event.
.google.protobuf.Timestamp detection_time = 10;
| Returns | |
|---|---|
| Type | Description |
TimestampOrBuilder |
|
getDetectionTimingDetails(int index)
public Collection.DetectionTimingDetails getDetectionTimingDetails(int index)Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Parameter | |
|---|---|
| Name | Description |
index |
intThe index of the element to return. |
| Returns | |
|---|---|
| Type | Description |
Collection.DetectionTimingDetails |
The detectionTimingDetails at the given index. |
getDetectionTimingDetailsCount()
public int getDetectionTimingDetailsCount()Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Returns | |
|---|---|
| Type | Description |
int |
The count of detectionTimingDetails. |
getDetectionTimingDetailsList()
public List<Collection.DetectionTimingDetails> getDetectionTimingDetailsList()Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Returns | |
|---|---|
| Type | Description |
List<DetectionTimingDetails> |
A list containing the detectionTimingDetails. |
getDetectionTimingDetailsValue(int index)
public int getDetectionTimingDetailsValue(int index)Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Parameter | |
|---|---|
| Name | Description |
index |
intThe index of the value to return. |
| Returns | |
|---|---|
| Type | Description |
int |
The enum numeric value on the wire of detectionTimingDetails at the given index. |
getDetectionTimingDetailsValueList()
public List<Integer> getDetectionTimingDetailsValueList()Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Returns | |
|---|---|
| Type | Description |
List<Integer> |
A list containing the enum numeric values on the wire for detectionTimingDetails. |
getId()
public String getId()Unique ID for the collection. The ID is specific to the type of collection. For example, with rule detections this is the detection ID.
string id = 7;
| Returns | |
|---|---|
| Type | Description |
String |
The id. |
getIdBytes()
public ByteString getIdBytes()Unique ID for the collection. The ID is specific to the type of collection. For example, with rule detections this is the detection ID.
string id = 7;
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes for id. |
getIdNamespace()
public Id.Namespace getIdNamespace()The ID namespace used for the Collection.
.google.backstory.Id.Namespace id_namespace = 12;
| Returns | |
|---|---|
| Type | Description |
Id.Namespace |
The idNamespace. |
getIdNamespaceValue()
public int getIdNamespaceValue()The ID namespace used for the Collection.
.google.backstory.Id.Namespace id_namespace = 12;
| Returns | |
|---|---|
| Type | Description |
int |
The enum numeric value on the wire for idNamespace. |
getInvestigation()
public Investigation getInvestigation()Consolidated investigation details (categorization, status, etc) typically for collections that begin as detection findings and then evolve with analyst action and feedback into investigations around the detection output.
.google.backstory.Investigation investigation = 4;
| Returns | |
|---|---|
| Type | Description |
Investigation |
The investigation. |
getInvestigationBuilder()
public Investigation.Builder getInvestigationBuilder()Consolidated investigation details (categorization, status, etc) typically for collections that begin as detection findings and then evolve with analyst action and feedback into investigations around the detection output.
.google.backstory.Investigation investigation = 4;
| Returns | |
|---|---|
| Type | Description |
Investigation.Builder |
|
getInvestigationOrBuilder()
public InvestigationOrBuilder getInvestigationOrBuilder()Consolidated investigation details (categorization, status, etc) typically for collections that begin as detection findings and then evolve with analyst action and feedback into investigations around the detection output.
.google.backstory.Investigation investigation = 4;
| Returns | |
|---|---|
| Type | Description |
InvestigationOrBuilder |
|
getLastUpdatedTime()
public Timestamp getLastUpdatedTime()Time the collection was last updated.
.google.protobuf.Timestamp last_updated_time = 6;
| Returns | |
|---|---|
| Type | Description |
Timestamp |
The lastUpdatedTime. |
getLastUpdatedTimeBuilder()
public Timestamp.Builder getLastUpdatedTimeBuilder()Time the collection was last updated.
.google.protobuf.Timestamp last_updated_time = 6;
| Returns | |
|---|---|
| Type | Description |
Builder |
|
getLastUpdatedTimeOrBuilder()
public TimestampOrBuilder getLastUpdatedTimeOrBuilder()Time the collection was last updated.
.google.protobuf.Timestamp last_updated_time = 6;
| Returns | |
|---|---|
| Type | Description |
TimestampOrBuilder |
|
getLatencyMetrics()
public LatencyMetrics getLatencyMetrics()The latency metrics for the specific detection. These metrics are calculated from ALL of the events that contribute to the detection, not just the sampled ones.
.google.backstory.LatencyMetrics latency_metrics = 21;
| Returns | |
|---|---|
| Type | Description |
LatencyMetrics |
The latencyMetrics. |
getLatencyMetricsBuilder()
public LatencyMetrics.Builder getLatencyMetricsBuilder()The latency metrics for the specific detection. These metrics are calculated from ALL of the events that contribute to the detection, not just the sampled ones.
.google.backstory.LatencyMetrics latency_metrics = 21;
| Returns | |
|---|---|
| Type | Description |
LatencyMetrics.Builder |
|
getLatencyMetricsOrBuilder()
public LatencyMetricsOrBuilder getLatencyMetricsOrBuilder()The latency metrics for the specific detection. These metrics are calculated from ALL of the events that contribute to the detection, not just the sampled ones.
.google.backstory.LatencyMetrics latency_metrics = 21;
| Returns | |
|---|---|
| Type | Description |
LatencyMetricsOrBuilder |
|
getResponsePlatformInfo()
public ResponsePlatformInfo getResponsePlatformInfo()Alert related info of this same alert in customer's SOAR platform.
.google.backstory.ResponsePlatformInfo response_platform_info = 13;
| Returns | |
|---|---|
| Type | Description |
ResponsePlatformInfo |
The responsePlatformInfo. |
getResponsePlatformInfoBuilder()
public ResponsePlatformInfo.Builder getResponsePlatformInfoBuilder()Alert related info of this same alert in customer's SOAR platform.
.google.backstory.ResponsePlatformInfo response_platform_info = 13;
| Returns | |
|---|---|
| Type | Description |
ResponsePlatformInfo.Builder |
|
getResponsePlatformInfoOrBuilder()
public ResponsePlatformInfoOrBuilder getResponsePlatformInfoOrBuilder()Alert related info of this same alert in customer's SOAR platform.
.google.backstory.ResponsePlatformInfo response_platform_info = 13;
| Returns | |
|---|---|
| Type | Description |
ResponsePlatformInfoOrBuilder |
|
getRuleRunFrequency()
public Collection.RunFrequency getRuleRunFrequency()The run frequency of the rule when it generated the detection.
.google.backstory.Collection.RunFrequency rule_run_frequency = 22;
| Returns | |
|---|---|
| Type | Description |
Collection.RunFrequency |
The ruleRunFrequency. |
getRuleRunFrequencyValue()
public int getRuleRunFrequencyValue()The run frequency of the rule when it generated the detection.
.google.backstory.Collection.RunFrequency rule_run_frequency = 22;
| Returns | |
|---|---|
| Type | Description |
int |
The enum numeric value on the wire for ruleRunFrequency. |
getSimulatedEventCount()
public long getSimulatedEventCount()The total number of simulated events that contributed to this detection. Simulated events are realistic threat sequences (Raw Logs or UDM) programmatically delivered into the production ingestion pipeline to verify the entire detection lifecycle—from identification to action.
int64 simulated_event_count = 23;
| Returns | |
|---|---|
| Type | Description |
long |
The simulatedEventCount. |
getSimulatedEventNames(int index)
public String getSimulatedEventNames(int index)The set of all values from event ingestion_labels where SIMULATED is set as the key, for all simulated events that participated in this detection.
repeated string simulated_event_names = 24;
| Parameter | |
|---|---|
| Name | Description |
index |
intThe index of the element to return. |
| Returns | |
|---|---|
| Type | Description |
String |
The simulatedEventNames at the given index. |
getSimulatedEventNamesBytes(int index)
public ByteString getSimulatedEventNamesBytes(int index)The set of all values from event ingestion_labels where SIMULATED is set as the key, for all simulated events that participated in this detection.
repeated string simulated_event_names = 24;
| Parameter | |
|---|---|
| Name | Description |
index |
intThe index of the value to return. |
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes of the simulatedEventNames at the given index. |
getSimulatedEventNamesCount()
public int getSimulatedEventNamesCount()The set of all values from event ingestion_labels where SIMULATED is set as the key, for all simulated events that participated in this detection.
repeated string simulated_event_names = 24;
| Returns | |
|---|---|
| Type | Description |
int |
The count of simulatedEventNames. |
getSimulatedEventNamesList()
public ProtocolStringList getSimulatedEventNamesList()The set of all values from event ingestion_labels where SIMULATED is set as the key, for all simulated events that participated in this detection.
repeated string simulated_event_names = 24;
| Returns | |
|---|---|
| Type | Description |
ProtocolStringList |
A list containing the simulatedEventNames. |
getSoarAlert()
public boolean getSoarAlert()A boolean field indicating that the alert is present in SOAR.
bool soar_alert = 17;
| Returns | |
|---|---|
| Type | Description |
boolean |
The soarAlert. |
getSoarAlertMetadata()
public SoarAlertMetadata getSoarAlertMetadata()Metadata fields of alerts coming from other SIEM systems via SOAR.
.google.backstory.SoarAlertMetadata soar_alert_metadata = 18;
| Returns | |
|---|---|
| Type | Description |
SoarAlertMetadata |
The soarAlertMetadata. |
getSoarAlertMetadataBuilder()
public SoarAlertMetadata.Builder getSoarAlertMetadataBuilder()Metadata fields of alerts coming from other SIEM systems via SOAR.
.google.backstory.SoarAlertMetadata soar_alert_metadata = 18;
| Returns | |
|---|---|
| Type | Description |
SoarAlertMetadata.Builder |
|
getSoarAlertMetadataOrBuilder()
public SoarAlertMetadataOrBuilder getSoarAlertMetadataOrBuilder()Metadata fields of alerts coming from other SIEM systems via SOAR.
.google.backstory.SoarAlertMetadata soar_alert_metadata = 18;
| Returns | |
|---|---|
| Type | Description |
SoarAlertMetadataOrBuilder |
|
getTags(int index)
public String getTags(int index)Tags set by UC/DSML/RE for the Finding during creation.
repeated string tags = 11;
| Parameter | |
|---|---|
| Name | Description |
index |
intThe index of the element to return. |
| Returns | |
|---|---|
| Type | Description |
String |
The tags at the given index. |
getTagsBytes(int index)
public ByteString getTagsBytes(int index)Tags set by UC/DSML/RE for the Finding during creation.
repeated string tags = 11;
| Parameter | |
|---|---|
| Name | Description |
index |
intThe index of the value to return. |
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes of the tags at the given index. |
getTagsCount()
public int getTagsCount()Tags set by UC/DSML/RE for the Finding during creation.
repeated string tags = 11;
| Returns | |
|---|---|
| Type | Description |
int |
The count of tags. |
getTagsList()
public ProtocolStringList getTagsList()Tags set by UC/DSML/RE for the Finding during creation.
repeated string tags = 11;
| Returns | |
|---|---|
| Type | Description |
ProtocolStringList |
A list containing the tags. |
getTimeWindow()
public Interval getTimeWindow()Time interval that the collection represents.
.google.type.Interval time_window = 8;
| Returns | |
|---|---|
| Type | Description |
com.google.type.Interval |
The timeWindow. |
getTimeWindowBuilder()
public Interval.Builder getTimeWindowBuilder()Time interval that the collection represents.
.google.type.Interval time_window = 8;
| Returns | |
|---|---|
| Type | Description |
com.google.type.Interval.Builder |
|
getTimeWindowOrBuilder()
public IntervalOrBuilder getTimeWindowOrBuilder()Time interval that the collection represents.
.google.type.Interval time_window = 8;
| Returns | |
|---|---|
| Type | Description |
com.google.type.IntervalOrBuilder |
|
getType()
public Collection.CollectionType getType()What the collection represents.
.google.backstory.Collection.CollectionType type = 1;
| Returns | |
|---|---|
| Type | Description |
Collection.CollectionType |
The type. |
getTypeValue()
public int getTypeValue()What the collection represents.
.google.backstory.Collection.CollectionType type = 1;
| Returns | |
|---|---|
| Type | Description |
int |
The enum numeric value on the wire for type. |
hasCreatedTime()
public boolean hasCreatedTime()Time the collection was created.
.google.protobuf.Timestamp created_time = 5;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the createdTime field is set. |
hasDetectionTime()
public boolean hasDetectionTime()Timestamp within the time_window related to the time of the collection_elements. For Rule Detections, this timestamp is the end of the the time_window for multi-event rules or the time of the event for single event rules. For late-arriving events that trigger new alerts, the detection_time will be the event time of the event.
.google.protobuf.Timestamp detection_time = 10;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the detectionTime field is set. |
hasInvestigation()
public boolean hasInvestigation()Consolidated investigation details (categorization, status, etc) typically for collections that begin as detection findings and then evolve with analyst action and feedback into investigations around the detection output.
.google.backstory.Investigation investigation = 4;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the investigation field is set. |
hasLastUpdatedTime()
public boolean hasLastUpdatedTime()Time the collection was last updated.
.google.protobuf.Timestamp last_updated_time = 6;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the lastUpdatedTime field is set. |
hasLatencyMetrics()
public boolean hasLatencyMetrics()The latency metrics for the specific detection. These metrics are calculated from ALL of the events that contribute to the detection, not just the sampled ones.
.google.backstory.LatencyMetrics latency_metrics = 21;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the latencyMetrics field is set. |
hasResponsePlatformInfo()
public boolean hasResponsePlatformInfo()Alert related info of this same alert in customer's SOAR platform.
.google.backstory.ResponsePlatformInfo response_platform_info = 13;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the responsePlatformInfo field is set. |
hasSoarAlertMetadata()
public boolean hasSoarAlertMetadata()Metadata fields of alerts coming from other SIEM systems via SOAR.
.google.backstory.SoarAlertMetadata soar_alert_metadata = 18;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the soarAlertMetadata field is set. |
hasTimeWindow()
public boolean hasTimeWindow()Time interval that the collection represents.
.google.type.Interval time_window = 8;
| Returns | |
|---|---|
| Type | Description |
boolean |
Whether the timeWindow field is set. |
internalGetFieldAccessorTable()
protected GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()| Returns | |
|---|---|
| Type | Description |
FieldAccessorTable |
|
isInitialized()
public final boolean isInitialized()| Returns | |
|---|---|
| Type | Description |
boolean |
|
mergeCreatedTime(Timestamp value)
public Collection.Builder mergeCreatedTime(Timestamp value)Time the collection was created.
.google.protobuf.Timestamp created_time = 5;
| Parameter | |
|---|---|
| Name | Description |
value |
Timestamp |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
mergeDetectionTime(Timestamp value)
public Collection.Builder mergeDetectionTime(Timestamp value)Timestamp within the time_window related to the time of the collection_elements. For Rule Detections, this timestamp is the end of the the time_window for multi-event rules or the time of the event for single event rules. For late-arriving events that trigger new alerts, the detection_time will be the event time of the event.
.google.protobuf.Timestamp detection_time = 10;
| Parameter | |
|---|---|
| Name | Description |
value |
Timestamp |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
mergeFrom(Collection other)
public Collection.Builder mergeFrom(Collection other)| Parameter | |
|---|---|
| Name | Description |
other |
Collection |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public Collection.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)| Parameters | |
|---|---|
| Name | Description |
input |
CodedInputStream |
extensionRegistry |
ExtensionRegistryLite |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
| Exceptions | |
|---|---|
| Type | Description |
IOException |
|
mergeFrom(Message other)
public Collection.Builder mergeFrom(Message other)| Parameter | |
|---|---|
| Name | Description |
other |
Message |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
mergeInvestigation(Investigation value)
public Collection.Builder mergeInvestigation(Investigation value)Consolidated investigation details (categorization, status, etc) typically for collections that begin as detection findings and then evolve with analyst action and feedback into investigations around the detection output.
.google.backstory.Investigation investigation = 4;
| Parameter | |
|---|---|
| Name | Description |
value |
Investigation |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
mergeLastUpdatedTime(Timestamp value)
public Collection.Builder mergeLastUpdatedTime(Timestamp value)Time the collection was last updated.
.google.protobuf.Timestamp last_updated_time = 6;
| Parameter | |
|---|---|
| Name | Description |
value |
Timestamp |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
mergeLatencyMetrics(LatencyMetrics value)
public Collection.Builder mergeLatencyMetrics(LatencyMetrics value)The latency metrics for the specific detection. These metrics are calculated from ALL of the events that contribute to the detection, not just the sampled ones.
.google.backstory.LatencyMetrics latency_metrics = 21;
| Parameter | |
|---|---|
| Name | Description |
value |
LatencyMetrics |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
mergeResponsePlatformInfo(ResponsePlatformInfo value)
public Collection.Builder mergeResponsePlatformInfo(ResponsePlatformInfo value)Alert related info of this same alert in customer's SOAR platform.
.google.backstory.ResponsePlatformInfo response_platform_info = 13;
| Parameter | |
|---|---|
| Name | Description |
value |
ResponsePlatformInfo |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
mergeSoarAlertMetadata(SoarAlertMetadata value)
public Collection.Builder mergeSoarAlertMetadata(SoarAlertMetadata value)Metadata fields of alerts coming from other SIEM systems via SOAR.
.google.backstory.SoarAlertMetadata soar_alert_metadata = 18;
| Parameter | |
|---|---|
| Name | Description |
value |
SoarAlertMetadata |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
mergeTimeWindow(Interval value)
public Collection.Builder mergeTimeWindow(Interval value)Time interval that the collection represents.
.google.type.Interval time_window = 8;
| Parameter | |
|---|---|
| Name | Description |
value |
com.google.type.Interval |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
removeCollectionElements(int index)
public Collection.Builder removeCollectionElements(int index)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
removeDetection(int index)
public Collection.Builder removeDetection(int index)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setCaseName(String value)
public Collection.Builder setCaseName(String value)The resource name of the Case that this collection belongs to. Example: projects/{project id}/locations/{region}/chronicle/cases/{internal_case_id}
string case_name = 14;
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe caseName to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setCaseNameBytes(ByteString value)
public Collection.Builder setCaseNameBytes(ByteString value)The resource name of the Case that this collection belongs to. Example: projects/{project id}/locations/{region}/chronicle/cases/{internal_case_id}
string case_name = 14;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes for caseName to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setCollectionElements(int index, Element value)
public Collection.Builder setCollectionElements(int index, Element value)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
value |
Element |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setCollectionElements(int index, Element.Builder builderForValue)
public Collection.Builder setCollectionElements(int index, Element.Builder builderForValue)Constituent elements of the collection. Each element shares an association that groups it together and is a component of the overall collection. For example, a detection collection may have several constituent elements that each share a correlation association that together represent a particular pattern or behavior.
repeated .google.backstory.Element collection_elements = 9;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
builderForValue |
Element.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setCreatedTime(Timestamp value)
public Collection.Builder setCreatedTime(Timestamp value)Time the collection was created.
.google.protobuf.Timestamp created_time = 5;
| Parameter | |
|---|---|
| Name | Description |
value |
Timestamp |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setCreatedTime(Timestamp.Builder builderForValue)
public Collection.Builder setCreatedTime(Timestamp.Builder builderForValue)Time the collection was created.
.google.protobuf.Timestamp created_time = 5;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setDataAccessScope(String value)
public Collection.Builder setDataAccessScope(String value)The resource name of the DataAccessScope of this collection.
string data_access_scope = 19;
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe dataAccessScope to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setDataAccessScopeBytes(ByteString value)
public Collection.Builder setDataAccessScopeBytes(ByteString value)The resource name of the DataAccessScope of this collection.
string data_access_scope = 19;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes for dataAccessScope to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setDetection(int index, SecurityResult value)
public Collection.Builder setDetection(int index, SecurityResult value)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
value |
SecurityResult |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setDetection(int index, SecurityResult.Builder builderForValue)
public Collection.Builder setDetection(int index, SecurityResult.Builder builderForValue)Detection metadata for findings that represent detections, can include rule details, machine learning model metadata, and indicators implicated in the detection (using the .about field).
repeated .google.backstory.SecurityResult detection = 3;
| Parameters | |
|---|---|
| Name | Description |
index |
int |
builderForValue |
SecurityResult.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setDetectionTime(Timestamp value)
public Collection.Builder setDetectionTime(Timestamp value)Timestamp within the time_window related to the time of the collection_elements. For Rule Detections, this timestamp is the end of the the time_window for multi-event rules or the time of the event for single event rules. For late-arriving events that trigger new alerts, the detection_time will be the event time of the event.
.google.protobuf.Timestamp detection_time = 10;
| Parameter | |
|---|---|
| Name | Description |
value |
Timestamp |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setDetectionTime(Timestamp.Builder builderForValue)
public Collection.Builder setDetectionTime(Timestamp.Builder builderForValue)Timestamp within the time_window related to the time of the collection_elements. For Rule Detections, this timestamp is the end of the the time_window for multi-event rules or the time of the event for single event rules. For late-arriving events that trigger new alerts, the detection_time will be the event time of the event.
.google.protobuf.Timestamp detection_time = 10;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setDetectionTimingDetails(int index, Collection.DetectionTimingDetails value)
public Collection.Builder setDetectionTimingDetails(int index, Collection.DetectionTimingDetails value)Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Parameters | |
|---|---|
| Name | Description |
index |
intThe index to set the value at. |
value |
Collection.DetectionTimingDetailsThe detectionTimingDetails to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setDetectionTimingDetailsValue(int index, int value)
public Collection.Builder setDetectionTimingDetailsValue(int index, int value)Detection timing details for the collection. These details are used to determine prossible causes of latency for the detection. This field is only set for detections that are generated by rules.
repeated .google.backstory.Collection.DetectionTimingDetails detection_timing_details = 20;
| Parameters | |
|---|---|
| Name | Description |
index |
intThe index to set the value at. |
value |
intThe enum numeric value on the wire for detectionTimingDetails to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setId(String value)
public Collection.Builder setId(String value)Unique ID for the collection. The ID is specific to the type of collection. For example, with rule detections this is the detection ID.
string id = 7;
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe id to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setIdBytes(ByteString value)
public Collection.Builder setIdBytes(ByteString value)Unique ID for the collection. The ID is specific to the type of collection. For example, with rule detections this is the detection ID.
string id = 7;
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes for id to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setIdNamespace(Id.Namespace value)
public Collection.Builder setIdNamespace(Id.Namespace value)The ID namespace used for the Collection.
.google.backstory.Id.Namespace id_namespace = 12;
| Parameter | |
|---|---|
| Name | Description |
value |
Id.NamespaceThe idNamespace to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setIdNamespaceValue(int value)
public Collection.Builder setIdNamespaceValue(int value)The ID namespace used for the Collection.
.google.backstory.Id.Namespace id_namespace = 12;
| Parameter | |
|---|---|
| Name | Description |
value |
intThe enum numeric value on the wire for idNamespace to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setInvestigation(Investigation value)
public Collection.Builder setInvestigation(Investigation value)Consolidated investigation details (categorization, status, etc) typically for collections that begin as detection findings and then evolve with analyst action and feedback into investigations around the detection output.
.google.backstory.Investigation investigation = 4;
| Parameter | |
|---|---|
| Name | Description |
value |
Investigation |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setInvestigation(Investigation.Builder builderForValue)
public Collection.Builder setInvestigation(Investigation.Builder builderForValue)Consolidated investigation details (categorization, status, etc) typically for collections that begin as detection findings and then evolve with analyst action and feedback into investigations around the detection output.
.google.backstory.Investigation investigation = 4;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
Investigation.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setLastUpdatedTime(Timestamp value)
public Collection.Builder setLastUpdatedTime(Timestamp value)Time the collection was last updated.
.google.protobuf.Timestamp last_updated_time = 6;
| Parameter | |
|---|---|
| Name | Description |
value |
Timestamp |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setLastUpdatedTime(Timestamp.Builder builderForValue)
public Collection.Builder setLastUpdatedTime(Timestamp.Builder builderForValue)Time the collection was last updated.
.google.protobuf.Timestamp last_updated_time = 6;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setLatencyMetrics(LatencyMetrics value)
public Collection.Builder setLatencyMetrics(LatencyMetrics value)The latency metrics for the specific detection. These metrics are calculated from ALL of the events that contribute to the detection, not just the sampled ones.
.google.backstory.LatencyMetrics latency_metrics = 21;
| Parameter | |
|---|---|
| Name | Description |
value |
LatencyMetrics |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setLatencyMetrics(LatencyMetrics.Builder builderForValue)
public Collection.Builder setLatencyMetrics(LatencyMetrics.Builder builderForValue)The latency metrics for the specific detection. These metrics are calculated from ALL of the events that contribute to the detection, not just the sampled ones.
.google.backstory.LatencyMetrics latency_metrics = 21;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
LatencyMetrics.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setResponsePlatformInfo(ResponsePlatformInfo value)
public Collection.Builder setResponsePlatformInfo(ResponsePlatformInfo value)Alert related info of this same alert in customer's SOAR platform.
.google.backstory.ResponsePlatformInfo response_platform_info = 13;
| Parameter | |
|---|---|
| Name | Description |
value |
ResponsePlatformInfo |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setResponsePlatformInfo(ResponsePlatformInfo.Builder builderForValue)
public Collection.Builder setResponsePlatformInfo(ResponsePlatformInfo.Builder builderForValue)Alert related info of this same alert in customer's SOAR platform.
.google.backstory.ResponsePlatformInfo response_platform_info = 13;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
ResponsePlatformInfo.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setRuleRunFrequency(Collection.RunFrequency value)
public Collection.Builder setRuleRunFrequency(Collection.RunFrequency value)The run frequency of the rule when it generated the detection.
.google.backstory.Collection.RunFrequency rule_run_frequency = 22;
| Parameter | |
|---|---|
| Name | Description |
value |
Collection.RunFrequencyThe ruleRunFrequency to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setRuleRunFrequencyValue(int value)
public Collection.Builder setRuleRunFrequencyValue(int value)The run frequency of the rule when it generated the detection.
.google.backstory.Collection.RunFrequency rule_run_frequency = 22;
| Parameter | |
|---|---|
| Name | Description |
value |
intThe enum numeric value on the wire for ruleRunFrequency to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setSimulatedEventCount(long value)
public Collection.Builder setSimulatedEventCount(long value)The total number of simulated events that contributed to this detection. Simulated events are realistic threat sequences (Raw Logs or UDM) programmatically delivered into the production ingestion pipeline to verify the entire detection lifecycle—from identification to action.
int64 simulated_event_count = 23;
| Parameter | |
|---|---|
| Name | Description |
value |
longThe simulatedEventCount to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setSimulatedEventNames(int index, String value)
public Collection.Builder setSimulatedEventNames(int index, String value)The set of all values from event ingestion_labels where SIMULATED is set as the key, for all simulated events that participated in this detection.
repeated string simulated_event_names = 24;
| Parameters | |
|---|---|
| Name | Description |
index |
intThe index to set the value at. |
value |
StringThe simulatedEventNames to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setSoarAlert(boolean value)
public Collection.Builder setSoarAlert(boolean value)A boolean field indicating that the alert is present in SOAR.
bool soar_alert = 17;
| Parameter | |
|---|---|
| Name | Description |
value |
booleanThe soarAlert to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setSoarAlertMetadata(SoarAlertMetadata value)
public Collection.Builder setSoarAlertMetadata(SoarAlertMetadata value)Metadata fields of alerts coming from other SIEM systems via SOAR.
.google.backstory.SoarAlertMetadata soar_alert_metadata = 18;
| Parameter | |
|---|---|
| Name | Description |
value |
SoarAlertMetadata |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setSoarAlertMetadata(SoarAlertMetadata.Builder builderForValue)
public Collection.Builder setSoarAlertMetadata(SoarAlertMetadata.Builder builderForValue)Metadata fields of alerts coming from other SIEM systems via SOAR.
.google.backstory.SoarAlertMetadata soar_alert_metadata = 18;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
SoarAlertMetadata.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setTags(int index, String value)
public Collection.Builder setTags(int index, String value)Tags set by UC/DSML/RE for the Finding during creation.
repeated string tags = 11;
| Parameters | |
|---|---|
| Name | Description |
index |
intThe index to set the value at. |
value |
StringThe tags to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setTimeWindow(Interval value)
public Collection.Builder setTimeWindow(Interval value)Time interval that the collection represents.
.google.type.Interval time_window = 8;
| Parameter | |
|---|---|
| Name | Description |
value |
com.google.type.Interval |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setTimeWindow(Interval.Builder builderForValue)
public Collection.Builder setTimeWindow(Interval.Builder builderForValue)Time interval that the collection represents.
.google.type.Interval time_window = 8;
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
com.google.type.Interval.Builder |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
|
setType(Collection.CollectionType value)
public Collection.Builder setType(Collection.CollectionType value)What the collection represents.
.google.backstory.Collection.CollectionType type = 1;
| Parameter | |
|---|---|
| Name | Description |
value |
Collection.CollectionTypeThe type to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |
setTypeValue(int value)
public Collection.Builder setTypeValue(int value)What the collection represents.
.google.backstory.Collection.CollectionType type = 1;
| Parameter | |
|---|---|
| Name | Description |
value |
intThe enum numeric value on the wire for type to set. |
| Returns | |
|---|---|
| Type | Description |
Collection.Builder |
This builder for chaining. |