Use PM_Dictionary validator from VNF-SDK to validate PM_Dictionary files when onboarding ZIP package
Issue-ID: SDC-3390
Signed-off-by: Adam Wudzinski <adam.wudzinski@nokia.com>
Change-Id: I03fd622393d675977527b9845b6cf8b87b2ec0a3
--- /dev/null
+/*-
+ * ============LICENSE_START=======================================================
+ * SDC
+ * ================================================================================
+ * Copyright (C) 2020 Nokia. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * ============LICENSE_END=========================================================
+ */
+package org.openecomp.sdc.validation.impl.validators;
+
+import org.openecomp.core.validation.types.GlobalValidationContext;
+import org.openecomp.sdc.validation.Validator;
+
+/**
+ * Stub required for class creation in test scope
+ */
+public class PmDictionaryValidator implements Validator {
+
+ @Override
+ public void validate(GlobalValidationContext globalContext) {
+ }
+}
\ No newline at end of file
"enable": true,
"implementationClass": "org.openecomp.sdc.validation.impl.validators.SharedResourceGuideLineValidator"
},
+ "pmDictionaryValidator": {
+ "enable": true,
+ "implementationClass": "org.openecomp.sdc.validation.impl.validators.PmDictionaryValidator"
+ },
"forbiddenResourceGuideLineValidator": {
"enable": true,
"implementationClass": "org.openecomp.sdc.validation.impl.validators.ForbiddenResourceGuideLineValidator",
<!--
~ Copyright © 2016-2018 European Support Limited
+ ~ Copyright © 2020 Nokia
~
~ Licensed under the Apache License, Version 2.0 (the "License");
~ you may not use this file except in compliance with the License.
<artifactId>openecomp-sdc-validation-core</artifactId>
<version>${project.version}</version>
</dependency>
+ <dependency>
+ <groupId>org.onap.vnfsdk.validation</groupId>
+ <artifactId>validation-pmdictionary</artifactId>
+ <version>${onap.vnfsdk.validation.pmdictionary.version}</version>
+ </dependency>
+ <dependency>
+ <groupId>io.vavr</groupId>
+ <artifactId>vavr</artifactId>
+ <version>${io.vavr.version}</version>
+ </dependency>
</dependencies>
</project>
--- /dev/null
+/*-
+ * ============LICENSE_START=======================================================
+ * SDC
+ * ================================================================================
+ * Copyright (C) 2020 Nokia Intellectual Property. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * ============LICENSE_END=========================================================
+ */
+package org.openecomp.sdc.validation.impl.validators;
+
+import java.util.Set;
+
+class FileExtensionUtils {
+
+ private static final Set<String> VALID_PM_DICTIONARY_EXTENSIONS = Set.of(
+ "pmdict.yml",
+ "pmdict.yaml",
+ "pm_dict.yml",
+ "pm_dict.yaml",
+ "pmdictionary.yml",
+ "pmdictionary.yaml",
+ "pm_dictionary.yml",
+ "pm_dictionary.yaml"
+ );
+ private static final Set<String> VALID_YAML_EXTENSIONS = Set.of(
+ ".yaml",
+ ".yml",
+ ".env"
+ );
+
+ static boolean isYaml(String fileName) {
+ return isValidExt(fileName, VALID_YAML_EXTENSIONS);
+ }
+
+ static boolean isPmDictionary(String fileName) {
+ return isValidExt(fileName, VALID_PM_DICTIONARY_EXTENSIONS);
+ }
+
+ private static boolean isValidExt(String fileName, Set<String> validExtensions) {
+ String fileNameLower = fileName.toLowerCase();
+ return validExtensions.stream()
+ .anyMatch(fileNameLower::endsWith);
+ }
+}
--- /dev/null
+/*-
+ * ============LICENSE_START=======================================================
+ * SDC
+ * ================================================================================
+ * Copyright (C) 2020 Nokia Intellectual Property. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * ============LICENSE_END=========================================================
+ */
+
+package org.openecomp.sdc.validation.impl.validators;
+
+import io.vavr.control.Option;
+import io.vavr.control.Try;
+import java.io.InputStream;
+import java.util.List;
+import org.onap.validation.yaml.YamlContentValidator;
+import org.onap.validation.yaml.error.YamlDocumentValidationError;
+import org.openecomp.core.validation.ErrorMessageCode;
+import org.openecomp.core.validation.errors.ErrorMessagesFormatBuilder;
+import org.openecomp.core.validation.types.GlobalValidationContext;
+import org.openecomp.sdc.datatypes.error.ErrorLevel;
+import org.openecomp.sdc.validation.Validator;
+
+public class PmDictionaryValidator implements Validator {
+
+ private static final ErrorMessageCode PM_DICT_ERROR_CODE = new ErrorMessageCode("PM_DICT");
+
+ @Override
+ public void validate(GlobalValidationContext globalContext) {
+ globalContext.getFiles().stream()
+ .filter(FileExtensionUtils::isPmDictionary)
+ .map(fileName -> new ValidationHelper(globalContext, fileName))
+ .forEach(ValidationHelper::validate);
+ }
+
+ private static class ValidationHelper {
+
+ private final GlobalValidationContext globalContext;
+ private final String fileName;
+
+ private ValidationHelper(GlobalValidationContext globalContext, String fileName) {
+ this.globalContext = globalContext;
+ this.fileName = fileName;
+ }
+
+ public void validate() {
+ Option.ofOptional(globalContext.getFileContent(fileName))
+ .peek(this::validateFileContent)
+ .onEmpty(() -> addErrorToContext(formatMessage("File is empty")));
+ }
+
+ private void validateFileContent(InputStream inputStream) {
+ Try.of(inputStream::readAllBytes)
+ .mapTry(fileContent -> new YamlContentValidator().validate(fileContent))
+ .onSuccess(this::reportValidationErrorsIfPresent)
+ .onFailure(e -> addErrorToContext(formatMessage(e.getMessage())));
+ }
+
+ private void reportValidationErrorsIfPresent(List<YamlDocumentValidationError> validationErrors) {
+ validationErrors.stream()
+ .map(this::prepareValidationMessage)
+ .forEach(this::addErrorToContext);
+ }
+
+ private String prepareValidationMessage(YamlDocumentValidationError error) {
+ final String errorMessage = String.format("Document Number: %s, Path: %s, Problem: %s",
+ error.getYamlDocumentNumber(),
+ error.getPath(),
+ error.getMessage()
+ );
+ return formatMessage(errorMessage);
+ }
+
+ private String formatMessage(String message) {
+ return ErrorMessagesFormatBuilder
+ .getErrorWithParameters(PM_DICT_ERROR_CODE, message);
+ }
+
+ private void addErrorToContext(String message) {
+ globalContext.addMessage(fileName, ErrorLevel.ERROR, message);
+ }
+ }
+}
/*
* Copyright © 2016-2017 European Support Limited
+ * Copyright © 2020 Nokia
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@Override
public void validate(GlobalValidationContext globalContext) {
Collection<String> files = globalContext.files(
- (fileName, globalValidationContext) -> fileName.endsWith(".yaml")
- || fileName.endsWith(".yml") || fileName.endsWith(".env"));
+ (fileName, globalValidationContext) -> FileExtensionUtils.isYaml(fileName)
+ && !FileExtensionUtils.isPmDictionary(fileName));
- files.stream().forEach(fileName -> validate(fileName, globalContext));
+ files.forEach(fileName -> validate(fileName, globalContext));
}
private void validate(String fileName, GlobalValidationContext globalContext) {
Optional<InputStream> rowContent = globalContext.getFileContent(fileName);
- if (!rowContent.isPresent()) {
+ if (rowContent.isEmpty()) {
globalContext.addMessage(fileName, ErrorLevel.ERROR, ErrorMessagesFormatBuilder
.getErrorWithParameters(ERROR_CODE_YML_1, Messages
.INVALID_YAML_FORMAT_REASON.getErrorMessage(),
--- /dev/null
+/*-
+ * ============LICENSE_START=======================================================
+ * SDC
+ * ================================================================================
+ * Copyright (C) 2020 Nokia Intellectual Property. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * ============LICENSE_END=========================================================
+ */
+package org.openecomp.sdc.validation.impl.validators;
+
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.util.Set;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+import org.junit.jupiter.api.Test;
+
+class FileExtensionUtilsTest {
+
+ private static final Set<String> VALID_YAML_EXTENSIONS = Set.of(
+ ".yaml",
+ ".yml",
+ ".env"
+ );
+ private static final Set<String> INVALID_YAML_EXTENSIONS = Set.of(
+ ".txt",
+ ".java",
+ ".properties"
+ );
+
+ private static final Set<String> VALID_PM_DICTIONARY_EXTENSIONS = Set.of(
+ "pmdict.yml",
+ "pmdict.yaml",
+ "pm_dict.yml",
+ "pm_dict.yaml",
+ "pmdictionary.yml",
+ "pmdictionary.yaml",
+ "pm_dictionary.yml",
+ "pm_dictionary.yaml"
+ );
+ private static final Set<String> INVALID_PM_DICTIONARY_EXTENSIONS = Set.of(
+ "pmdict.txt",
+ "pmdict.java",
+ "pm.yml"
+ );
+
+ private static final Set<String> TEST_FILE_PREFIXES = Set.of(
+ "test",
+ "test_file"
+ );
+
+ @Test
+ void shouldMatchProperYamlExtensions() {
+ final boolean allValidFilesMatched = constructTestFilenamesWithExtensions(VALID_YAML_EXTENSIONS)
+ .allMatch(FileExtensionUtils::isYaml);
+
+ assertTrue(allValidFilesMatched);
+ }
+
+ @Test
+ void shouldNotMatchImproperYamlExtensions() {
+ final boolean allInvalidFilesNotMatched = constructTestFilenamesWithExtensions(INVALID_YAML_EXTENSIONS)
+ .noneMatch(FileExtensionUtils::isYaml);
+
+ assertTrue(allInvalidFilesNotMatched);
+ }
+
+ @Test
+ void shouldMatchProperPmDictionaryExtensions() {
+ final boolean allValidFilesMatched = constructTestFilenamesWithExtensions(VALID_PM_DICTIONARY_EXTENSIONS)
+ .allMatch(FileExtensionUtils::isPmDictionary);
+
+ assertTrue(allValidFilesMatched);
+ }
+
+ @Test
+ void shouldNotMatchImproperPmDictionaryExtensions() {
+ final boolean allInvalidFilesNotMatched = constructTestFilenamesWithExtensions(INVALID_PM_DICTIONARY_EXTENSIONS)
+ .noneMatch(FileExtensionUtils::isPmDictionary);
+
+ assertTrue(allInvalidFilesNotMatched);
+ }
+
+ private Stream<String> constructTestFilenamesWithExtensions(Set<String> extensions) {
+ return extensions.stream()
+ .flatMap(ext -> prepareFilenamesWithExtension(ext).stream());
+ }
+
+ private Set<String> prepareFilenamesWithExtension(String extension) {
+ return Stream.concat(
+ joinTestNamesWithExtension(extension.toLowerCase()),
+ joinTestNamesWithExtension(extension.toUpperCase())
+ ).collect(Collectors.toSet());
+ }
+
+ private Stream<String> joinTestNamesWithExtension(String extension) {
+ return TEST_FILE_PREFIXES.stream()
+ .map(prefix -> prefix + extension);
+ }
+}
\ No newline at end of file
--- /dev/null
+/*-
+ * ============LICENSE_START=======================================================
+ * SDC
+ * ================================================================================
+ * Copyright (C) 2020 Nokia Intellectual Property. All rights reserved.
+ * ================================================================================
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * ============LICENSE_END=========================================================
+ */
+
+package org.openecomp.sdc.validation.impl.validators;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+
+import java.util.Map;
+import org.junit.jupiter.api.Test;
+import org.openecomp.core.validation.types.MessageContainer;
+import org.openecomp.sdc.validation.util.ValidationTestUtil;
+
+public class PmDictionaryValidatorTest {
+
+ private static final String RESOURCE_PATH = "/org/openecomp/validation/validators/pm_dictionary_validator";
+ private static final String VALID_PM_DICTIONARY_YAML = "valid_pm_dictionary.yaml";
+ private static final String INVALID_PM_DICTIONARY_YAML = "invalid_pm_dictionary.yaml";
+
+ @Test
+ public void shouldNotReturnErrorsWhenValidPmDict() {
+ Map<String, MessageContainer> messages = runValidation(
+ RESOURCE_PATH + "/" + VALID_PM_DICTIONARY_YAML);
+
+ assertNotNull(messages);
+ assertEquals(0, messages.size());
+ }
+
+ @Test
+ public void shouldReturnErrorsWhenInvalidPmDict() {
+ Map<String, MessageContainer> messages = runValidation(
+ RESOURCE_PATH + "/" + INVALID_PM_DICTIONARY_YAML);
+
+ assertNotNull(messages);
+ assertNotNull(messages.get(INVALID_PM_DICTIONARY_YAML));
+ assertEquals(4, messages.get(INVALID_PM_DICTIONARY_YAML).getErrorMessageList().size());
+ }
+
+ private Map<String, MessageContainer> runValidation(String path) {
+ PmDictionaryValidator validator = new PmDictionaryValidator();
+ return ValidationTestUtil.testValidator(validator, path);
+ }
+}
\ No newline at end of file
--- /dev/null
+---
+# PM Dictionary schema specifying and describing the meta information
+# used to define perf3gpp measurements in the PM Dictionary
+pmMetaData:
+ presence: required
+ structure:
+ pmHeader:
+ presence: required
+ structure:
+ nfType:
+ presence: required
+ comment: NF type; should match the nfName-vendor string used in the fileReady
+ or perf3gpp eventName
+ pmDefSchemaVsn:
+ presence: required
+ value: 2.0
+ comment: PM Dictionary Schema Version from the VES Event Registration specification
+ pmDefVsn:
+ presence: required
+ comment: vendor-defined PM Dictionary version
+ pmFields:
+ presence: required
+ structure:
+ iMeasInfoId:
+ presence: required
+ comment: vendor-defined integer measurement group identifier
+ iMeasType:
+ presence: required
+ comment: vendor-defined integer identifier for the measType; must be combined
+ with measInfoId to identify a specific measurement.
+ measChangeType:
+ presence: required
+ value:
+ - added
+ - modified
+ - deleted
+ comment: indicates the type of change that occurred during measLastChange
+ measCollectionMethod:
+ presence: required
+ value:
+ - CC
+ - SI
+ - DER
+ - Gauge
+ - Average
+ comment: the measurement collection method; CC, SI, DER and Gauge are as
+ defined in 3GPP; average contains the average value of the measurement
+ during the granularity period
+ measCondition:
+ presence: required
+ comment: description of the condition causing the measurement
+ measDescription:
+ presence: required
+ comment: description of the measurement information and purpose
+ measFamily:
+ presence: required
+ comment: abbreviation for a family of measurements, in 3GPP format, or vendor
+ defined
+ measInfoId:
+ presence: required
+ comment: name for a group of related measurements in 3GPP format or vendor
+ defined
+ measLastChange:
+ presence: required
+ comment: version of the PM Dictionary the last time this measurement was
+ added, modified or deleted
+ measObjClass:
+ presence: required
+ value:
+ - NGBTS
+ - NGCELL
+ - IPNO
+ - IPSEC
+ - ETHIF
+ comment: measurement object class
+ measResultRange:
+ presence: optional
+ comment: range of the measurement result; only necessary when the range
+ is smaller than the full range of the data type
+ measResultType:
+ presence: required
+ value:
+ - float
+ - uint32
+ - uint64
+ comment: data type of the measurement result
+ measResultUnits:
+ presence: required
+ value:
+ - seconds
+ - minutes
+ - nanoseconds
+ - microseconds
+ - dB
+ - number
+ - kilobytes
+ - bytes
+ - ethernetFrames
+ - packets
+ - users
+ comment: units of measure for the measurement result
+ measType:
+ presence: required
+ comment: measurement name in 3GPP or vendor-specific format; vendor specific
+ names are preceded with VS
+ measAdditionalFields:
+ presence: required
+ comment: vendor-specific PM Dictionary fields
+ structure:
+ vendorField1:
+ presence: required
+ value:
+ - X
+ - Y
+ - Z
+ comment: vendor field 1 description
+ vendorField2:
+ presence: optional
+ value:
+ - A
+ - B
+ comment: vendor field 2 description.
+...
+# PM Dictionary perf3gpp measurements for the gnb-Nokia NF (bracket style yaml)
+---
+pmMetaData:
+ pmHeader:
+ nfType: gnb-Nokia
+ pmDefSchemaVsn: 2.0
+ pmDefVsn: 5G19_1906_002
+ pmFields:
+ iMeasInfoId: 2204
+ iMeasType: 1
+ measCollectionMethod: CC
+ measCondition: "This measurement is updated when X2AP: SgNB Modification Required message is sent to MeNB
+ with the SCG Change Indication set as PSCellChange."
+ measDescription: "This counter indicates the number of intra gNB intra frequency PSCell change attempts."
+ measFamily: NINFC
+ measInfoId: "NR Intra Frequency PSCell Change"
+ measLastChange: 5G18A_1807_003
+ measObjClass: NGCELL
+ measResultRange: 0-4096
+ measResultType: integer
+ measResultUnits: number
+ measType: VS.NINFC.IntraFrPscelChAttempt
+ measAdditionalFields:
+ vendorField1: X
+ vendorField2: B
+...
+---
+pmMetaData:
+ pmHeader:
+ nfType: gnb-Nokia
+ pmDefSchemaVsn: 2.0
+ pmDefVsn: 5G19_1906_002
+ pmFields:
+ iMeasInfoId: 2204
+ iMeasType: 2
+ measCollectionMethod: CC
+ measCondition: "This measurement is updated when the TDCoverall timer has elapsed before gNB receives the X2AP: SgNB Modification Confirm message."
+ measDescription: "This measurement the number of intra gNB intra frequency PSCell change failures due to TDCoverall timer expiry."
+ measFamily: NINFC
+ measInfoId: "NR Intra Frequency PSCell Change"
+ measLastChange: 5G18A_1807_003
+ measObjClass: NGCELL
+ measResultRange: 0-4096
+ measResultType: float
+ measResultUnits: number
+ measType: VS.NINFC.IntraFrPscelChFailTdcExp
+ measAdditionalFields:
+ vendorField1:
+ - Y
+ - X
+...
+---
+pmMetaData:
+ pmHeader:
+ nfType: gnb-Nokia
+ pmDefSchemaVsn: 2.0
+ pmDefVsn: 5G19_1906_002
+ pmFields:
+ iMeasInfoId: 2206
+ iMeasType: 1
+ measCondition: "This measurement is updated when MeNB replies to X2AP: SgNB Modification Required message with the X2AP: SgNB Modification Refuse message."
+ measCollectionMethod: CC
+ measDescription: "This counter indicates the number of intra gNB intra frequency PSCell change failures due to MeNB refusal."
+ measFamily: NINFC
+ measInfoId: "NR Intra Frequency PSCell Change"
+ measLastChange: 5G19_1906_002
+ measObjClass: NGCELL
+ measResultRange: 0-4096
+ measResultType: float
+ measChangeType: added
+ measResultUnits: number
+ measType: VS.NINFC.IntraFrPscelChFailMenbRef
+ measAdditionalFields:
+ vendorField1:
+ - Z
+ - A
+ vendorField2: A
+...
+---
+pmMetaData:
+ pmHeader:
+ nfType: gnb-Nokia
+ pmDefSchemaVsn: 2.0
+ pmDefVsn: 5G19_1906_002
+ pmFields:
+ iMeasInfoId: 2206
+ iMeasType: 1
+ measCondition: "This measurement is updated when MeNB replies to X2AP: SgNB Modification Required message with the X2AP: SgNB Modification Refuse message."
+ measCollectionMethod: CC
+ measDescription: "This counter indicates the number of intra gNB intra frequency PSCell change failures due to MeNB refusal."
+ measFamily: NINFC
+ measInfoId: "NR Intra Frequency PSCell Change"
+ measLastChange: 5G19_1906_002
+ measObjClass: NGCELL
+ measResultRange: 0-4096
+ measResultType: float
+ measChangeType: added
+ measResultUnits: number
+ measType: VS.NINFC.IntraFrPscelChFailMenbRef
+ measAdditionalFields:
+ vendorField1:
+ - X
+ - Y
+ vendorField2: A
+...
--- /dev/null
+---
+# PM Dictionary schema specifying and describing the meta information
+# used to define perf3gpp measurements in the PM Dictionary
+pmMetaData:
+ presence: required
+ structure:
+ pmHeader:
+ presence: required
+ structure:
+ nfType:
+ presence: required
+ comment: NF type; should match the nfName-vendor string used in the fileReady
+ or perf3gpp eventName
+ pmDefSchemaVsn:
+ presence: required
+ value: 2.0
+ comment: PM Dictionary Schema Version from the VES Event Registration specification
+ pmDefVsn:
+ presence: required
+ comment: vendor-defined PM Dictionary version
+ pmFields:
+ presence: required
+ structure:
+ iMeasInfoId:
+ presence: required
+ comment: vendor-defined integer measurement group identifier
+ iMeasType:
+ presence: required
+ comment: vendor-defined integer identifier for the measType; must be combined
+ with measInfoId to identify a specific measurement.
+ measChangeType:
+ presence: required
+ value:
+ - added
+ - modified
+ - deleted
+ comment: indicates the type of change that occurred during measLastChange
+ measCollectionMethod:
+ presence: required
+ value:
+ - CC
+ - SI
+ - DER
+ - Gauge
+ - Average
+ comment: the measurement collection method; CC, SI, DER and Gauge are as
+ defined in 3GPP; average contains the average value of the measurement
+ during the granularity period
+ measCondition:
+ presence: required
+ comment: description of the condition causing the measurement
+ measDescription:
+ presence: required
+ comment: description of the measurement information and purpose
+ measFamily:
+ presence: required
+ comment: abbreviation for a family of measurements, in 3GPP format, or vendor
+ defined
+ measInfoId:
+ presence: required
+ comment: name for a group of related measurements in 3GPP format or vendor
+ defined
+ measLastChange:
+ presence: required
+ comment: version of the PM Dictionary the last time this measurement was
+ added, modified or deleted
+ measObjClass:
+ presence: required
+ value:
+ - NGBTS
+ - NGCELL
+ - IPNO
+ - IPSEC
+ - ETHIF
+ comment: measurement object class
+ measResultRange:
+ presence: optional
+ comment: range of the measurement result; only necessary when the range
+ is smaller than the full range of the data type
+ measResultType:
+ presence: required
+ value:
+ - float
+ - uint32
+ - uint64
+ comment: data type of the measurement result
+ measResultUnits:
+ presence: required
+ value:
+ - seconds
+ - minutes
+ - nanoseconds
+ - microseconds
+ - dB
+ - number
+ - kilobytes
+ - bytes
+ - ethernetFrames
+ - packets
+ - users
+ comment: units of measure for the measurement result
+ measType:
+ presence: required
+ comment: measurement name in 3GPP or vendor-specific format; vendor specific
+ names are preceded with VS
+ measAdditionalFields:
+ presence: required
+ comment: vendor-specific PM Dictionary fields
+ structure:
+ vendorField1:
+ presence: required
+ value:
+ - X
+ - Y
+ - Z
+ comment: vendor field 1 description
+ vendorField2:
+ presence: optional
+ value:
+ - A
+ - B
+ comment: vendor field 2 description.
+...
+# PM Dictionary perf3gpp measurements for the gnb-Nokia NF (bracket style yaml)
+---
+pmMetaData:
+ pmHeader:
+ nfType: gnb-Nokia
+ pmDefSchemaVsn: 2.0
+ pmDefVsn: 5G19_1906_002
+ pmFields:
+ iMeasInfoId: 2204
+ iMeasType: 1
+ measCollectionMethod: CC
+ measCondition: "This measurement is updated when X2AP: SgNB Modification Required message is sent to MeNB
+ with the SCG Change Indication set as PSCellChange."
+ measDescription: "This counter indicates the number of intra gNB intra frequency PSCell change attempts."
+ measFamily: NINFC
+ measInfoId: "NR Intra Frequency PSCell Change"
+ measLastChange: 5G18A_1807_003
+ measObjClass: NGCELL
+ measResultRange: 0-4096
+ measResultType: float
+ measChangeType: added
+ measResultUnits: number
+ measType: VS.NINFC.IntraFrPscelChAttempt
+ measAdditionalFields:
+ vendorField1: X
+ vendorField2: B
+...
+---
+pmMetaData:
+ pmHeader:
+ nfType: gnb-Nokia
+ pmDefSchemaVsn: 2.0
+ pmDefVsn: 5G19_1906_002
+ pmFields:
+ iMeasInfoId: 2204
+ iMeasType: 2
+ measCollectionMethod: CC
+ measCondition: "This measurement is updated when the TDCoverall timer has elapsed before gNB receives the X2AP: SgNB Modification Confirm message."
+ measDescription: "This measurement the number of intra gNB intra frequency PSCell change failures due to TDCoverall timer expiry."
+ measFamily: NINFC
+ measInfoId: "NR Intra Frequency PSCell Change"
+ measLastChange: 5G18A_1807_003
+ measObjClass: NGCELL
+ measResultRange: 0-4096
+ measResultType: float
+ measChangeType: added
+ measResultUnits: number
+ measType: VS.NINFC.IntraFrPscelChFailTdcExp
+ measAdditionalFields:
+ vendorField1:
+ - Y
+ - X
+...
+---
+pmMetaData:
+ pmHeader:
+ nfType: gnb-Nokia
+ pmDefSchemaVsn: 2.0
+ pmDefVsn: 5G19_1906_002
+ pmFields:
+ iMeasInfoId: 2206
+ iMeasType: 1
+ measCondition: "This measurement is updated when MeNB replies to X2AP: SgNB Modification Required message with the X2AP: SgNB Modification Refuse message."
+ measCollectionMethod: CC
+ measDescription: "This counter indicates the number of intra gNB intra frequency PSCell change failures due to MeNB refusal."
+ measFamily: NINFC
+ measInfoId: "NR Intra Frequency PSCell Change"
+ measLastChange: 5G19_1906_002
+ measObjClass: NGCELL
+ measResultRange: 0-4096
+ measResultType: float
+ measChangeType: added
+ measResultUnits: number
+ measType: VS.NINFC.IntraFrPscelChFailMenbRef
+ measAdditionalFields:
+ vendorField1:
+ - X
+ - Y
+ vendorField2: A
+...
+---
+pmMetaData:
+ pmHeader:
+ nfType: gnb-Nokia
+ pmDefSchemaVsn: 2.0
+ pmDefVsn: 5G19_1906_002
+ pmFields:
+ iMeasInfoId: 2206
+ iMeasType: 1
+ measCondition: "This measurement is updated when MeNB replies to X2AP: SgNB Modification Required message with the X2AP: SgNB Modification Refuse message."
+ measCollectionMethod: CC
+ measDescription: "This counter indicates the number of intra gNB intra frequency PSCell change failures due to MeNB refusal."
+ measFamily: NINFC
+ measInfoId: "NR Intra Frequency PSCell Change"
+ measLastChange: 5G19_1906_002
+ measObjClass: NGCELL
+ measResultRange: 0-4096
+ measResultType: float
+ measChangeType: added
+ measResultUnits: number
+ measType: VS.NINFC.IntraFrPscelChFailMenbRef
+ measAdditionalFields:
+ vendorField1:
+ - X
+ - Z
+ vendorField2: A
+...
<onap.logging.version>1.6.1</onap.logging.version>
<apache-commons-text.version>1.9</apache-commons-text.version>
<jaxb-api.version>2.3.1</jaxb-api.version>
+ <io.vavr.version>0.10.3</io.vavr.version>
<commons.collections.version>4.1</commons.collections.version>
<ws.rs.version>2.1</ws.rs.version>
<httpcore.version>4.4.1</httpcore.version>
<json-simple.version>1.1</json-simple.version>
+ <!-- PM Dictionary validation -->
+ <onap.vnfsdk.validation.pmdictionary.version>1.2.15</onap.vnfsdk.validation.pmdictionary.version>
+
<!-- Logging start -->
<!-- logback -->
<logback.version>1.2.3</logback.version>
Code Review / sdc.git / commitdiff