Instantiation Rules
POMBA audit reports are generated based on the rules that applied in the rules engine generating the violations. The following is an initial capture of rules
| Rule | Data Sources | Attributes | Description | Category | Severity | Story | Release |
|---|---|---|---|---|---|---|---|---|
1 | Attribute Comparison | A&AI, SDN-C, Network Discovery | All | This rule compares all attributes by the same name from different Context Builders and returns a violation if the fields do no match. This includes the case where the name is present by the value is null in one of the cases. It does not produce a violation if one of the Context Builders is missing an attribute. Note in Casablanca, this will be implemented in a non-generic way, and made more generic as a future work item | Attribute Mismatch | ERROR | Casablanca | |
2 | vnfc-type |
|
| Validate that each VNFC instance in AAI conforms VNFC type defined in SDC model | VNFC Consistency | ERROR | Casablanca | |
3 | vnfc-count |
|
| Validate that for each VNFC node defined in SDC model there is at least one VNFC instance in AAI | VNFC Consistency | WARN | Casablanca | |
4 | vf-module-type |
|
| Validate that each VF module instance in AAI conforms VF Module defined in SDC service model | VF Consistency | CRITICAL | Casablanca | |
5 | nfc-naming-code |
| nfc-naming-code | Validate that nfc-naming-code exists and is populated in AAI VNFC instance | Expected Field Populated | CRITICAL | Casablanca | |
6 | data-dictionary-valid-value |
| All (assuming we can tell if not defined in dictionary) | Validates for a particular field that its value aligns to what is in the data dictionary | Invalid Value | ERROR |
| |
7 | vserver-vfmodule |
|
| If vfModule is present, I expect vserver/VMs to be present within this structure. |
|
| Coming soon to release near you | Future |
8 | dataQuality | * |
| When there is a problem with the data provided to the validation engine (data missing due to system issues, etc), this rule shall raise violations. Longer term the plan is to report this in a separate dataQuality field. Attributes only |
|
| Casablanca, not done as a rulehttps://lf-onap.atlassian.net/browse/LOG-454 | Future |
9 | nf-role | aai-instance | nf-role | Ensure nf-role was populated in VNF |
|
|
| Future |
10 | SDNC |
|
| Compare SDNC reported data against same fields in other data sources |
|
| Dublin | |
11 | data dictionary |
|
| Validate attributes of resources contain valid values, when present in data dictionary and data source |
|
|
|
Note that Attribute Comparison in particular needs to check against the following, but should check everything it can
Network Discovered attributes
Existing AA&I and SDNC Comparisons for
vnf-type
vnf-name
nf-naming-code
Newly supported A&AI and SDNC attributes that align with those that have been network discovered
and
Deletion Rules
In the future, we will add additional rules to be able to audit that a service has been completely deleted. POMBA will likely require an input parameter on the audit initiation request to indicate whether someone wishes to run the instantiation rule set or the deletion rule sets.
Adding New Rules
The rules that POMBA runs are extensible and anyone can add new rules. Note this is in code currently, but can be done outside of the development cycle and manually applied if desired. Ideas for rules probably fall into two categories
Validating design intent
When designing ONAP features, you may wish to add rules to verify that the system is in the state you expect
Automation of detecting errors found manually
When using or testing the system, you may manually find a data integrity issue and wish to automate its detection in case it happens again