Groupings
Incoming data can be tagged with user defined key value pairs for facilitating analytics. The key value pair is called a grouping in the LOGIQ platform. A destination may specify one or more groupings to be applied to the incoming data message.
1
destinations:
2
- name: t_webservers
3
partition: p_by_day
4
s3:
5
bucket: logiqcloud
6
region: us-east-1
7
prefix: dev-logs
8
credential: athenas3
9
groupings:
10
- name: Environment
11
value: Production
12
- name: Tier
13
value: Web
Copied!
The LOGIQ platform provides the below built-in groupings that are common. Additional groupings can be defined by the user when setting up the configuration file.
1
groupings:
2
-
3
name: Environment
4
values:
5
- Production
6
- Staging
7
- Development
8
- QA
9
- UAT
10
description: The Environment for which the log is being collected
11
-
12
name: Tier
13
values:
14
- Database
15
- Web
16
- Cache
17
- LoadBalancer
18
- Queue
19
- Analytics
20
- Logger
21
- Unknown
22
description: The Tier of the app typically in a multi-tier application
Copied!
Built-in groupings can be extended by adding extra values. This is done by creating a grouping definition in the configuration file with the same name. The user defined values are merged with the built-in values.
Custom groupings are defined using the "groupings" keyword and related attributes.
1
groupings:
2
-
3
name: CustomGrouping
4
values:
5
- foo
6
- bar
7
- baz
Copied!
The attribute details for defining custom groupings are defined below.

name [required]

Every grouping definition needs to have a name. The name defines a key for the grouping.

values [required]

A grouping key can have one or more possible values. The values keyword enumerates all possible values allowed for a grouping key.

description [required]

A description for a grouping is a human readable text that explains the purpose of the grouping/classification being done.

Cardinality

When specifying a grouping for a destination, multiple values for the same key are allowed.
Last modified 2yr ago