Components installed with API Insights
Summarize
Summary of Components Installed with API Insights
The API Insights plugin activates several components including user roles, tables, scheduled jobs, and additional plugins essential for managing and analyzing API data within ServiceNow. These components facilitate the organization and oversight of APIs, enhancing operational efficiency.
Show less
Key Features
- Roles Installed:
- Enterprise Architect Administrator: Full access to the API Insights workspace for searching APIs and managing data model recommendations.
- Enterprise Architect: Access to monitor APIs, track usage, and manage the API lifecycle.
- Scheduled Jobs Installed:
- Gather APIs without Business App relationship: Identifies APIs lacking business context.
- Import ServiceNow API to API Insights: Imports APIs from the ServiceNow registry.
- Sync Ownership Groups of API Versions: Synchronizes ownership information for API versions.
- API Specification Validation: Validates API specifications automatically.
- Tag Based Relationship Mapping: Maps APIs to application services using tags.
- Tables Installed:
- APIs Missing Relationships: Records APIs with no defined relationships.
- API Specification: Contains API specification details.
- Importable ServiceNow APIs: Lists APIs that can be imported from ServiceNow.
- Open API Specifications: Holds OpenAPI specification records.
- Push API Specification: Manages records for pushing API specifications.
- API Requests Access Task: Tracks tasks related to API access requests.
- Specification Validation Rule: Defines validation rules for API specifications.
- API Metric Configuration: Maps discovery sources to metrics in MetricBase.
- Tag Based Relationship Mapping: Establishes mapping rules between APIs and business applications.
- Plugins Installed:
- MetricBase: Handles time-series data analysis and visualization.
- ServiceNow Store Applications: Includes tools for value selection, CMDB management, and visual mapping.
Key Outcomes
By leveraging the API Insights components, ServiceNow customers can enhance their API management capabilities, gain insights into API usage and relationships, and ensure compliance with specifications. This results in improved operational efficiency and better alignment of APIs with business objectives.
Several types of components are installed with activation of the API Insights plugin, including tables, user roles, and scheduled jobs.
Roles installed
| Role title [name] | Description | Contains roles |
|---|---|---|
|
Enterprise architect administrator [sn_api_insights_ws.api_mgmt_architect_admin] |
Accesses the API Insights workspace to search APIs, review data model recommendations, monitors API connections, evaluate metrics on API usage, and set parameters for data model recommendations and de-duplication tasks. |
sn_api_insights_ws.api_mgmt_architect |
|
Enterprise architect [sn_api_insights_ws.api_mgmt_architect] |
Accesses the API Insights workspace to search APIs, monitor team APIs, view managed and subscribed APIs, track API activity, review API access requests, and manage API life cycle aspects, including APIs without business context, ownership, product models, or designs. |
|
Scheduled jobs installed
| Scheduled job | Description |
|---|---|
| Gather APIs without Business App relationship |
Identifies and collects APIs that do not have an associated business context also called as business application. |
| Import ServiceNow API to API Insights | Retrieves ServiceNow APIs from the ServiceNow registry and imports them into API Insights. |
| Import ServiceNow API usage to MetricBase | Collects ServiceNow API usage data and pushes it to the MetricBase application. |
| SyncOwnershipGroupsOfAPIVersions | Synchronizes ownership groups for API versions in API Insights. |
| API Specification Validation | Performs automated validation of API specifications in an instance. |
| Tag based relationship mapping | Applies tag-based mapping rules between APIs and application services or business applications. |
Tables installed
| Table | Description |
|---|---|
|
APIs missing relationships [sn_api_insights_ws_apis_missing_relationships] |
API records that lack a defined relationship. |
|
API Specification [sn_api_insights_ws_api_specification] |
API specification details, such as OpenAPI definitions. |
|
Importable ServiceNow APIs [sn_api_insights_ws_importable_servicenow_api] |
Details of APIs imported from ServiceNow. |
|
Open API Specifications [sn_api_insights_ws_openapi_specifications] |
OpenAPI specification records for API Insights. |
|
Push API Specification [sn_api_insights_ws_push_api_spec] |
Records for pushing API specifications. |
|
API Requests Access Task [sn_api_insights_ws_request_access_task] |
Tasks related to API access requests. |
|
Specification Validation Rule [sn_api_insights_ws_spec_validation_rule] |
Validation rules that validate API specifications based on the configured rules. |
|
API Metric Configuration [sn_api_insights_ws_api_metric_config] |
Configuration that maps each discovery source to the MetricBase application used for analytics, defining the metric name, whether it applies at API or component level, and the metric type (usage, error rate, latency, cache hit). |
| Tag Based Relationship Mapping [sn_api_insights_ws_tag_relationship_mapping] |
Relationship rules that apply tag-based mapping between APIs and application services or business applications, defining the CI types involved, the relationship type, and which CI acts as the parent. |
Plugins installed
| Plugin | Description |
|---|---|
|
MetricBase (com.snc.clotho) |
Collects, retains, analyzes, graphs, and acts on time-series data. |
ServiceNow Store applications installed
| Application | Description |
|---|---|
|
@devsnc/sn-list-selector (sn_list-selector) |
Enables selecting a set of values from a simple or multi-dimensional data source. |
|
CMDB CI Class Models (sn_cmdb_ci_class) |
Provides the single source for all new base-system CMDB CI class models defined by ServiceNow. |
|
CMDB Workspace (sn_cmdb_ws) |
Enables a workspace for working with the CMDB to search and explore the CMDB, understand its health, work on related tasks, view activity, performance and feature usage, and access various management tools to support tasks in an organization. |
|
Node map Experience Component (sn_node_map) |
Enables mapping and visualizing connections between concepts. |
|
SGC Central (sn_sgc_central) |
Enables discovering, installing, and monitoring Service Graph Connectors. |
|
Timeline component (sn_ui_timeline) |
Shows events and information across a timeline to contextualize history or important information for an object. |
|
UX Commons (sn_app_ux_commons) |
Enhances component experience with common UI Builder utilities, controllers, and bundles. |