AttributeS is a standalone subsystem within CGRateS and it is the equivalent of a key-value store. It is accessed via CGRateS RPC APIs.
As most of the other subsystems, it is performance oriented, stored inside DataDB but cached inside the cgr-engine process. Caching can be done dynamically/on-demand or at start-time/precached and it is configurable within cache section in the JSON configuration.
It is able to process generic events (hashmaps) and decision for matching it is outsourced to FilterS.
If there are multiple profiles (configurations) matching, the one with highest Weight will be the winner. There can be only one AttributeProfile processing the event per process run. If one configures multiple process runs either in JSON configuration or as parameter to the .ProcessEvent API call, the output event from one process run will be forwarded as input to the next selected profile. There will be independent AttributeProfile selection performed for each run, hence the event fields modified in one run can be applied as filters to the next process run, giving out the possibility to chain AttributeProfiles and have multiple replacements with a minimum of performance penalty (in-memory matching).
AttributeS is the CGRateS component responsible of handling the AttributeProfiles.
It is configured within attributes section from JSON configuration via the following parameters:
- Will enable starting of the service. Possible values: <true|false>.
- Enable profile matching exclusively on indexes. If not enabled, the ResourceProfiles are checked one by one which for a larger number can slow down the processing time. Possible values: <true|false>.
- Query string indexes based only on these fields for faster processing. If commented out, each field from the event will be checked against indexes. If uncommented and defined as empty list, no fields will be checked.
- Query prefix indexes based only on these fields for faster processing. If defined as empty list, no fields will be checked.
- Applied when all event fields are checked against indexes, and decides whether subfields are also checked.
- Limit the number of loops when processing an Event. The event loop is however clever enough to stop when the same processing occurs or no more additional profiles are matching, so higher numbers are ignored if not needed.
Represents the configuration for a group of attributes applied.
- The tenant on the platform (one can see the tenant as partition ID)
- Identifier for the AttributeProfile, unique within a Tenant
- A list of contexts applying to this profile. A context is usually associated with a logical phase during event processing (ie: *sessions or *cdrs for events parsed by SessionS or CDRs)
- List of FilterProfiles which should match in order to consider the AttributeProfile matching the event.
- The time interval when this profile becomes active. If undefined, the profile is always active. Other options are start time, end time or both.
- In case of multiple process runs are allowed, this flag will break further processing.
- Used in case of multiple profiles matching an event. The higher, the better (0 has lowest possible priority).
- List of Attribute objects part of this profile.
- List of FilterProfiles which should match in order to consider the Attribute matching the event.
- Identifying the targeted absolute path within the processed event.
Represents the type of substitution which will be performed on the Event. The following Types are available:
- The Value is a constant value, it will just set the FieldName to this value as it is.
- The Value is a RSRParser which will be able to capture the value out of one or more fields in the event (also combined with other constants) and write it to Path.
- Same as *variable but instead of overwriting Path, it will append to it.
- Will calculate the duration difference between two field names defined in the Value. If the number of fields in the Value are different than 2, it will error.
- Will sum up the values in the Value.
- Will compute the exponent of the first field in the Value.
- The value which will be set for Path. It can be a list of RSRParsers capturing even from multiple sources in the same event. If the Value is *remove the field with Path will be removed from Event
In order to facilitate quick attribute definition (without the need of separate AttributeProfile), one can define attributes directly as AttributeIDs following the special format.
Inline filter format:
- Fields aliasing * Number portability (replacing a dialed number with it’s translation) * Roaming (using Category to point out the zone where the user is roaming in so we can apply different rating or consume out of restricted account bundles).
- Appending new fields * Adding separate header with location information * Adding additional rating information (ie: SMS only contains origin+destination, add Tenant, Account, Subject, RequestType) * Using as query language (ie: append user password for a given user so we can perform authorization on SIP Proxy side).