Components installed with API Insights
Summarize
Summary of Components Installed with API Insights
The API Insights plugin activates various components essential for managing and analyzing APIs within ServiceNow. These components include user roles, scheduled jobs, and tables that aid in API governance and monitoring.
Show less
Key Features
- Roles Installed:
- Enterprise Architect Administrator: Accesses the API Insights workspace for oversight of API usage, data model recommendations, and de-duplication tasks.
- Enterprise Architect: Monitors and manages APIs, tracks activities, and oversees API lifecycle aspects without business context.
- Scheduled Jobs:
- Gather APIs without Business App relationship: Identifies APIs lacking business context.
- Import ServiceNow API to API Insights: Retrieves and imports ServiceNow APIs into API Insights.
- Import ServiceNow API usage to MetricBase: Collects and pushes API usage data to MetricBase.
- SyncOwnershipGroupsOfAPIVersions: Synchronizes ownership groups for API versions.
- API Specification Validation: Performs automated validation of API specifications.
- Tag Based Relationship Mapping: Applies mapping rules between APIs and application services.
- Tables Installed:
- APIs Missing Relationships: Records APIs lacking defined relationships.
- API Specification: Details API specifications, including OpenAPI definitions.
- Importable ServiceNow APIs: Information on imported ServiceNow APIs.
- Open API Specifications: Records for API Insights.
- Push API Specification: Manages records for pushing API specifications.
- API Requests Access Task: Manages tasks related to API access requests.
- Specification Validation Rule: Validation rules for API specifications.
- API Metric Configuration: Maps discovery sources to MetricBase for analytics.
- Tag Based Relationship Mapping: Defines relationship rules for tag-based mapping.
- Plugins Installed:
- MetricBase: Analyzes time-series data.
- ServiceNow Store Applications: Includes various tools for enhancing user experience and managing CMDB.
Key Outcomes
By utilizing these components, ServiceNow customers can effectively manage their API landscape, enhance visibility into API usage, and ensure compliance with organizational standards. The integration of these elements facilitates streamlined API governance and improved operational insights.
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. |