Validating Service Definition YAMLs

이 페이지는 아직 한국어로 제공되지 않으며 번역 작업 중입니다. 번역에 관한 질문이나 의견이 있으시면 언제든지 저희에게 연락해 주십시오.

Overview

Software Catalog uses service definition schemas to store and display metadata about your services. These schemas follow the JSON Schema specification, so you can validate your metadata as you edit it. This validation is important, because a mistake in a service definition file could cause you to create a service with invalid data or introduce an error into the metadata of an existing service.

To prevent this, there are two ways for you to validate your service definition files:

Create the service definition in-app

To validate your service definition file in-app:

  1. Navigate to the Software Catalog Setup & Config page.
  2. Click Create a New Entry.
  3. Select the Code tab.
  4. Paste the schema content.

Validate with an IDE extension

Built-in validation mechanisms prevent you from sending incorrect metadata into Software Catalog.

Service metadata editor showing sample service definition.

Validate with Datadog Event Management and Github Integration

To validate your service definitions ingested by Datadog’s Github integration, you can view events when services or updated or when there is an error. You can view validation errors in Event Management by filtering by source:software_catalog and status:error. Adjust the timeframe as needed.

Github event showing error message from service definition.

Further reading