Reference

Asset Ingestion Error Log

The asset ingestion error log gives you a list of asset ingestion status and error messages that helps you take the required corrective actions before reingesting the asset model and data.

Look at each error message; it contains a message string with embedded variables to help troubleshoot a specific area in the ingestion JSON file. For example, in the error message, Invalid ccomClass "ENTTYPE" specified for Classification: "Company" contains text within doublequotes (""), which are values provided for a specific field. In the example message, ENTTYPE is an invalid value for the field ccomClass. The message suggests that the Classification object defined with the ID value Company does not have a valid ccomClass value.

In the application user interface, actual values will replace the variable names represented within square brackets [ ] in the error messages below.

Table 1. Ingestion Error Messages and Corrective Actions
Error MessageCorrective Action
JSON file [filename] is not well formed.Make sure that the JSON contained within the ZIP file is properly formatted. Before zipping the file for upload, use a JSON validator such as jsonlint or jsonformatter to check for JSON validity. Also make sure that the JSON conforms to the expected asset model schema.
Missing ID for Classification: [Name], Type: [ccomClass]Make sure that the ID field does not contain an empty string or null value. You must fill the ID field for all elements in the classifications block.
Missing ID for Instance: [Name], Type: [ccomClass] Make sure that the ID field does not contain an empty string or null value. You must fill the ID field for all elements in the instances block.
Missing ID for Tag Classification: [Name]Make sure that the ID field does not contain an empty string or null value. You must fill the ID field for all elements in the tagClassfications block.
Missing ID for Tag: [Name], Monitored Entity: [ID]Make sure that the ID field does not contain an empty string or null value. You must fill the ID field for all elements in the tagAssociations block.
Missing ID for Connection: From [From ID] - Type [ccomClass] To: [To ID] - Type [ccomClass]You must define the instances before you can connect them. You can have a parent-child relationship between instances. You define connection from one instance to one or more instances. Make sure that the ID field does not contain an empty string or null value. You must fill the ID field for all instances linked in the connections block. You must enter a valid and existing ID for already ingested instances only.
Invalid field length for Attribute: [Attribute Name], Instance: [ID] The ID field limits values to 32768 characters (32KB) long. Make sure that the ID values are no longer than the allowed limit.
Invalid field length for Attribute: [Attribute Name], Classification: [ID] The ID field limits values to 32768 characters (32KB) long. Make sure that the ID values are no longer than the allowed limit.
Invalid field length for Attribute: [Attribute Name], Tag: [ID] The ID field limits values to 32768 characters (32KB) long. Make sure that the ID values are no longer than the allowed limit.
Invalid field length for Attribute: [Attribute Name], Tag Classification: [ID] The ID field limits values to 32768 characters (32KB) long. Make sure that the ID values are no longer than the allowed limit.
Invalid data type for Attribute: [Attribute Name], Instance: [ID]Enter one of the following supported datatypes in the property object within the instances block.Refer to Refer to "Attribute Data Types and Values" for the list of supported data-types and expected values. Make sure that the value is within the expected range of the datatype defined. For example, if the attribute has the datatype INTEGER then the value provided must be of type integer only. Otherwise, validation would fail.
Invalid data type for Attribute: [Attribute Name], Classifcation: [ID]Enter one of the following supported datatypes in the property object within the classifications block. Refer to Refer to "Attribute Data Types and Values" for the list of supported data-types and expected values. Make sure that the value is within the expected range of the datatype defined. For example, if the attribute has the datatype INTEGER then the value provided must be of type integer only. Otherwise, validation would fail.
Invalid data type for Attribute: [Attribute Name], Tag: [ID]Enter one of the following supported datatypes in the property object within the tags block. Refer to "Attribute Data Types and Values" for the list of supported data-types and expected values. Make sure that the value is within the expected range of the datatype defined. For example, if the attribute has the datatype INTEGER then the value provided must be of type integer only. Otherwise, validation would fail.
Invalid data type for Attribute: [Attribute Name], Tag Classification: [ID]Enter one of the following supported datatypes in the property object within the tagClassifications block. Refer to "Attribute Data Types and Values" for the list of supported data-types and expected values. Make sure that the value is within the expected range of the datatype defined. For example, if the attribute has the datatype INTEGER then the value provided must be of type integer only. Otherwise, validation would fail.
Invalid ccomClass "ABC" specified for Instance: [ID]The APM s95 adapter uses four ccomClasses to represent the levels within the asset model hierarchy. Each class instance must be tied to one of the four ccomClasses: ENTERPRISE, SITE, SEGMENT, and ASSET. It should also match the classification ccomclass. For example, if the ccomClass for the classification is Enterprise_type then the instance of that classification must have the ccomClass Enterprise.
"ccomClass":"ENTERPRISE"
Invalid ccomClass "ABC" specified for Classification: [ID]The APM s95 adapter uses four ccomClasses to represent the levels within the asset model hierarchy. Each classification must be tied to one of the four ccomClasses: ENTERPRISE_TYPE, SITE_TYPE, SEGMENT_TYPE, and ASSET_TYPE. If inherited, must match the ccomClass of the parent classification.
"ccomClass":"ASSET_TYPE"
Invalid ccomClass "ABC" specified for Connection From [From ID] - Type [ccomClass] To: [To ID] - Type [ccomClass]Make sure that ccomClass of the parent and child instances in the connections block are correctly defined.

Keep in mind the following before connecting two instances:

  • An enterprise object is the parent of one or more site objects.
  • A site object is the parent of at least one segment or asset object. A site object cannot be a parent of another site object.
  • A segment object is the parent of at least one segment or asset object.
  • An asset object can be the parent of zero or more asset objects.