Administering data ingestion and model alignment with API Insights
Summarize
Summary of Administering Data Ingestion and Model Alignment with API Insights
The Overview tab in the API Insights workspace offers a centralized view of data ingestion activities and integration health. CMDB administrators can access this tab to monitor incoming API data, assess alignment with the data model, and address any misaligned or incomplete data, ensuring accurate CMDB records.
Show less
Key Features
- Search APIs: Locate specific APIs for review or management.
- Connection Status: View total active API connections and processing errors to ensure reliable data ingestion.
- Active Connections: Count of installed connections with active import schedules.
- Errors: Total number of processing errors for installed connections.
- API Clustering Recommendations: Displays clustering recommendations based on data model settings.
- APIs by Discovery Source: Count of discovered APIs grouped by source.
- APIs by Life Cycle: Count of APIs categorized into Operational, Deploy, or End of Life stages.
- APIs by Type: Categorization of APIs by protocol, including REST, GraphQL, and SOAP.
- APIs by Environment: Count of APIs deployed across Development, Test, and Production environments.
- APIs by Ownership Group: Count of APIs categorized by assigned ownership groups.
- APIs Missing Data: Count of APIs lacking key attributes, visually indicating severity to prioritize remediation.
- APIs by Business Application: Count of APIs linked to business applications to enhance integration tracking.
- Connections Overview: Summary of API data connections' status and activity using Service Graph Connectors.
Key Outcomes
By utilizing the Overview tab and its features, CMDB administrators can effectively monitor and manage API data ingestion. This leads to improved data quality, better alignment with the data model, and more efficient remediation of issues that affect the integrity of CMDB records.
The Overview tab in the API Insights workspace provides a centralized view of data ingestion activities and integration health.
Access the API Insights Overview tab
To access the Overview tab, navigate to . The Overview tab opens by default.
Required roles
Features
| Feature | Description | Required roles |
|---|---|---|
| Search APIs | API search within the organization to locate specific APIs for review or management. | sn_cmdb_admin |
| Connection status | Total count of active API connections and processing errors. Provides insight into the status of API connections and highlights any processing issues to verify reliable data ingestion.
|
sn_cmdb_admin and cmdb_inst_admin |
| API clustering recommendations | Number representing the current clustering recommendation, based on the data model recommendation settings. See Configure data model recommendations for API clustering in API Insights. |
sn_cmdb_admin, ml_report_user, and platform_ml_read |
| APIs by discovery source | Total count of discovered APIs grouped by source. Provides insight into the discovery methods of APIs across your organization. |
sn_cmdb_admin |
| APIs by life cycle | Total count of APIs grouped by life cycle stage as Operational, Deploy, or End of Life. Provides visibility into API readiness and maintenance status across your organization. |
sn_cmdb_admin |
| APIs by type | Total count of APIs categorized by protocol or communication type. Includes technologies such as REST, GraphQL, and SOAP, providing insight into the integration styles and interoperability across your organization. |
sn_cmdb_admin |
| APIs by environment | Count of APIs deployed in each environment. Highlights distribution across Development, Test, and Production stages, enabling monitoring of deployment progress and assessment of risk exposure. |
sn_cmdb_admin |
| APIs by ownership group | Total count of APIs categorized by assigned ownership group. Groups APIs by managing team or function, as defined by an enterprise architect administrator with the sn_api_insights_ws.api_mgmt_architect_admin role in settings. For more information on setting an ownership group, see Configure settings to manage APIs in API Insights. |
sn_cmdb_admin |
| APIs missing data | Count of APIs missing key attributes, including business context, ownership group, product model, or design. Each bar represents a key attribute and indicates the number of APIs missing the attribute. Color coding indicates the severity of missing data:
Use the visual indicator to prioritize remediation efforts based on data completeness. Select a bar in the bar chart to start the remediation process. See Identifying and remediating missing API data in API Insights. |
sn_cmdb_admin |
| APIs by business application | Count of APIs linked to business applications. Enables tracking of API connections to business applications to improve integration after connections are established. |
sn_cmdb_admin |
| Connections overview | Summary of the status and activity of API data connections using Service Graph Connectors, including counts of successful, failed, or unknown connection tests, recent import success rate, and the number of connections currently processing data imports. | sn_cmdb_admin and cmdb_inst_admin |