Components installed with API Insights
Summarize
Summary of Components Installed with API Insights
The API Insights plugin activates several components crucial for managing and analyzing APIs within ServiceNow. This includes user roles, scheduled jobs, and various tables that support API management tasks, enhancing visibility and control over API usage and relationships.
Show less
Key Features
- Roles Installed:
- Enterprise Architect Administrator: Manages API Insights workspace, oversees API connections, and configures data model recommendations.
- Enterprise Architect: Monitors team APIs, manages API lifecycle, and evaluates API access requests.
- Scheduled Jobs:
- Identifies APIs without a business context.
- Imports ServiceNow APIs and usage data into API Insights and MetricBase, respectively.
- Automated validation of API specifications and tag-based mapping between APIs and applications.
- Tables Installed:
- Records for APIs missing relationships, API specifications, and importable ServiceNow APIs.
- Validation rules for API specifications and configuration for API metrics.
- Plugins Installed:
- MetricBase for time-series data analytics.
- Applications for managing CMDB, visual mapping, and enhancing user experience.
Key Outcomes
By utilizing the API Insights components, ServiceNow customers can effectively monitor and manage their APIs, ensuring better alignment with business needs, improved API lifecycle management, and enhanced analytical capabilities. This leads to more informed decision-making and optimization of API usage across the organization.
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. |