Thank you for your feedback.
Form temporarily unavailable. Please try again or contact docfeedback@servicenow.com to submit your comments.

Components installed with Service Mapping

Log in to subscribe to topics and get notified when content changes.

Components installed with Service Mapping

Several types of components are installed with activation of the Service Mapping plugin, including tables, user roles, properties, and scheduled jobs.

Demo data is available for this feature.

Roles installed

Role title [name] Description Contains roles
[app_service_admin]

Creates and modifies application services, creates service groups, views, and edits application service maps.

[itil]
[app_service_user]

Views application service maps. The itil role that serves as the basic helpdesk technician role contains the app_service_user role.

cmdb_read
[itom_admin] Configure ITOM applications using the ITOM Guided Setup.
Note: The ITOM Guided Setup does not cover Service Mapping.
[sn_bm_client.benchmark_data_viewer]

[sm_itom_license.reader]

[sam_core_admin] An internal role. [sam_core_user]
[sam_core_user] An internal role. [itil]
[sm_admin]

Sets up the Service Mapping application. Maps, fixes, and maintains application services. Also performs advanced configuration and customization of the product. Assign this role to application administrators.

  • [app_service_admin]
  • [app_service_owner]
  • [discovery_admin]
  • [itil_admin]
  • [itom_admin]
  • [sam_core_admin]
  • [personalize_dictionary]
  • [pd_admin]
  • [pd_user]
[sm_app_owner]

Provides information necessary for successful mapping of an application service. Once a service is mapped, this user reviews the results and either approves it or suggests changes. Assign the sm_app_owner role to users who own application services and are familiar with the infrastructure and applications that make up the services.

[sm_user]
[sm_user]

Views maps for operational application service to plan change or migration, as well as analyze the continuity and availability of services. Assign this role to application users.

  • [sam_core_user]
  • [itil]
[sn_svc_err.admin] Fixes discovery errors in bulk using the error framework feature in Service Mapping and Discovery. [itil]
[pd_admin]

Creates new and modifies existing patterns, which Service Mapping and Discovery use for performing horizontal and top-down discovery.

[pd_user]

Scheduled jobs installed

Scheduled job Description
Deferred Discovery Cleanup [sysauto_script_ba4bee737f0022008f1c3b19befa9108] Runs every minute. Detects and cancels discovery schedules on TCP connections that are not in the active state anymore (5 minutes of no activity).
Update Query Based Services [sysauto_script_08745913f31131002e6bae4716612bf1] Runs every 10 minutes. Updates views for all defined technical services.
Update Business Service Status [sysauto_script_5641702ac32102003e76741e81d3ae9e] Runs every minute. Updates the discovery status attribute for application services. The discovery status is calculated as the overall status over all endpoints that an application servicecontains.
Flow Discovery Scheduler [sysauto_script_74c676f0dbb0220060ff742eaf9619f2] Runs every 10 minutes. Triggers the network flow discovery and writes the data into the [sa_flow_connector] table.
Save thread dumps [sysauto_script_a49cd030c302020039a3553a81d3aefb] Not active by default. When enabled, collects thread dumps and stores the data in the [sys_thread_dump] table.
Slow steps stats persist [sysauto_script_dc0de690c302020039a3553a81d3aee0] Runs every minute. Collects data on slow execution of pattern steps and writes this data into the [sys_step_pattern] table.
Calculate number of servers [sys_trigger_db438f407f510200f128134f8dfa91c6] Runs every Sunday. Updates the licensing metric with the overall number of discovered servers on instance. This information is used for billing. On domain separated instances, the number is updated for each domain.
Run DNS Lookup For All Entry Points and Manual Connection Endpoints [f178ab457fb213001952baf8befa91d3] Runs the DNS lookup probe on all entry points and manual connection endpoints and updates information on their IP addresses in the CMDB. This scheduled job is disabled by default.
[sys_auto_flush_5211e7e1c320220039a3553a81d3aee6] Cleans the [sa_flow_connection] table from records not updated for the last seven days.
[sys_auto_flush_956d498b938503006a7031f6357ffbec] Cleans the [sa_performance_statistics] table from records containing statistics of overall event processing time and created earlier than 30 days ago.
[sys_auto_flush_ce1a978193001200e0e931f6357ffb59] Cleans the [sa_performance_statistics] table from records created earlier than 2 days ago.
[sys_auto_flush_b24d9c30c302020039a3553a81d3ae53] Cleans the [sys_thread_dump] table from records created earlier than 7 days ago.
[sys_auto_flush_cf129ebe7f223200995cbaf8befa916f] Cleans the [sa_ml_feature_data] table from records not updated in the last 7 days, and have a special state (empty label field).
[sys_auto_flush_d2516be1c320220039a3553a81d3ae21] Cleans the [sa_flow_service] table from records not updated in the last 7 days.
[sys_auto_flush_db416be1c320220039a3553a81d3ae1f] Cleans the [sa_flow_server_comm] table from records not updated in the last 7 days.

Tables installed

Table Description
Pre Service Mapping Task Scripts

[sa_pre_task_script]

Contains scripts that Service Mapping runs on the instance and collect information that helps identify the relevant pattern for a CI.
Traffic Based Connection Qualifiers

[cmdb_ci_qualifier_traffic_based_connection]

Legacy content. Not used in the current version.
Query Based Service

[cmdb_ci_query_based_service]

Contains technical services.
Components

[sa_bs_components]

Contains information on components that are part of the application service. Customers enter this information manually in the Questionnaire tab of the application service form.
Candidate Entry Points

[sa_cand_entry_point]

Contains information on potential entry points that Service Mapping retrieved from load balancers or traffic-based connections.
Dashboard View

[sa_dashboard_view]

Contains configuration that defines which services to display in the Service tree.
Service Discovery Messages

[sa_discovery_message]

Contains discovery messages and errors that Service Mapping generates during the discovery process.
ITOM Error task

[sa_error_handler_task]

Contains information that Service Mapping and Discovery use for error-handling functionality.
Error EP AS Manual EP

[sa_errors_as_manual_ep]

Contains data on errors that customers skip during the following procedure: Skip errors to continue discovering an application service.
Boundary endpoints

[sa_m2m_boundary_endpoint_service]

Contains information about endpoints that customers marked as a boundary. For more information, refer to Remove CIs not belonging to application services
Manual connections

[sa_manual_connections]

Contains information on endpoints that customers use while adding manual connections.
ML Feature Data

[sa_ml_feature_data]

Internal table.
ML Model

[sa_ml_model]

Internal table
ML Traffic Validation

[sa_ml_traffic_validation]

Internal table
Performance Statistics

[sa_performance_statistics]

Internal table for storing performance data on impact calculation in Event Management.
Planned Custom Entry Point

[sa_planned_entry_points]

(Legacy) Contains planned entry points for the Service Mapping Planner module.
Note: Fresh install deployments do not have the Service Map Planner module.
Service Maps

[sa_service_counters]

Stores data about number of CIs and discovery errors per each discovered service.
Simulation entry points

[sa_simulation_entry_points]

Internal table.
Service Process Tasks

[service_process_task]

Stores data requests and review requests for application services.
Slow Steps

[sys_step_pattern]

Stores information about slow execution of pattern steps. This data is used for monitoring and troubleshooting.
Thread dump

[sys_thread_dump]

Internal table for storing performance data used for troubleshooting in Event Management.
Automation Error Category

[automation_error_category]

Stores all supported categories for errors.
Automation Error Categories Statistics

[automation_error_category_stats]

Stores the latest error statistics on all error categories.
Automation Error Code

[automation_error_code]

Stores all supported error codes for discovery errors.
Automation Error Code Statistics

[automation_error_code_stats]

Stores the latest error statistics on all error codes.
Automation Error Discovery Categories Statistics

[automation_error_discovery_category_stats]

Deprecated.
Automation Error Discovery Code Statistics

[automation_error_discovery_code_stats]

Deprecated.
Automation Error Discovery Message

[automation_error_discovery_msg]

Stores the latest error messages.
Automation error instance category statistics

[automation_error_instance_category_stats]

Stores the latest error statistics on all categories per instance (discovery status).
Automation Error Categories Statistics

[automation_error_instance_code_stats]

Stores the latest error statistics on all error codes per instance (discovery status).
Automation error instance message

[automation_error_instance_msg]

Stores all latest errors associated with the instance (discovery status).
Automation error instance message

[automation_error_stats_update_time]

Stores the last statistics update time for every application.
Automation Error Suggestion

[automation_error_suggestion]

Contains all the configured suggestions that presented in the UI per different error codes.
Automation Source Application

[automation_source_application]

Contains the source applications that are using the Discovery and Service Mapping error framework.
Mapping between suggestion and error code

[suggestion_error_code_m2m]

Contains information on mapping between error code and suggestion.
ITOM Error task

[sa_error_handler_task]

Contains the tasks configured per different groups of errors.
Applicative Credentials

[sa_applicative_credentials]

Contains credentials used when running application-specific commands on servers.
Service Mapping CI attributes

[sa_ci_attr]

Contains CI attributes relevant only for discovery process.
Related CI Types

[sa_ci_to_pattern]

Assigns CI types to patterns (relevant only for the horizontal discovery performed by Discovery).
Pattern Debugger Session

[sa_debug_session]

This internal table is used for the Pattern Designer components.
Pattern Debugger Session Status for UI

[sa_debug_session_status]

This internal table is used for the Pattern Designer components.
Sa Deferred Service Discovery

[sa_deferred_service_discovery]

This internal table is used for Service Mapping components.
Service Discovery Log

[sa_discovery_log]

Contains discovery logs collected by Service Mapping.
Service Discovery Messages

[sa_discovery_message]

Contains messages created by Service Mapping during service discovery.
Planned Business Service

[sa_dw_business_service]

Contains data on planned services created in Service Map Planner.
Components

[sa_dw_components]

Contains data on planned components created in Service Map Planner.
Check Connectivity Result

[sa_dw_connectivity_result]

Contains data on results of connectivity test performed in Service Map Planner.
Connectivity Test

[sa_dw_connectivity_test]

Contains data on connectivity tests performed in Service Map Planner.
Planned Custom Entry Point

[sa_dw_custom_entry_point]

Contains data on planned custom entry points in Service Map Planner.
Planned Entry Point

[sa_dw_entry_point]

Contains planned entry points used in Service Map Planner.
Planned Endpoint Attributes

[sa_dw_ep_attrs]

Contains attributes of planned entry point used in Service Map Planner.
Import Errors

[sa_dw_import_errors]

Contains import errors appearing in Service Map Planner.
Phase

[sa_dw_phase]

Contains planned phases in Service Map Planner.
Validation errors

[sw_dw_validation_errors]

Contains validation errors appearing in Service Map Planner.
Sa Endpoint Status

[sa_endpoint_status]

Contains discovery status for endpoints in Service Mapping.
Find Host Scripts

[sa_find_host_scripts]

Contains the names of script includes that find hosts based on the endpoint glide records.
nfdump file

[sa_flcon_file_nfdump]

This internal table contains information used for Netflow-based discovery.
nfdump install

[sa_flcon_local_nfdump]

This internal table contains information used for Netflow-based discovery.
AWS VPC flow logs

[sa_flcon_vpc_flow_log]

This internal table contains information used for Netflow-based discovery.
SA Flow Connection

[sa_flow_connection]

This internal table contains information used for Netflow-based discovery.
Flow Connector

[sa_flow_connector]

This internal table contains information used for Netflow-based discovery.
Flow Server Communication

[sa_flow_server_comm]

This internal table contains information used for Netflow-based discovery.
Flow Services IP/Port and Statistics

[sa_flow_service]

This internal table contains information used for Netflow-based discovery.
Host Class to Capability

[sa_host_class_to_capability]

Maps server type to capabilities required by Service Mapping.
Infra Path To Elements

[sa_infra_path_assoc]

Contains data on components which are part of a network path.
Mapping External Discovery Commands

[sa_mapping_ext_commands]

Contains data on customized commands created by user.
Network Paths

[sa_network_paths]

Contains data on network paths discovered by Service Mapping.
Horizontal Discovered Paged Payloads

[sa_paged_payload]

Service Mapping uses data in this table for splitting payload sent from the MID Server if the discovery results in a very large payload.
Discovery Patterns

[sa_pattern]

Contains preconfigured and customized patterns that Service Mapping uses for discovery.
Service Mapping Draft Pattern

[sa_pattern_draft]

Contains non-activated discovery patterns.
Service Mapping Relation attributes

[sa_rel_attr]

Contains relation attributes used during service discovery process.
Rel to Infra Path

[sa_rel_to_infra_path]

Maps relations to network or storage paths.
Service Mapping Server Usage

[sa_server_usage]

Contains count of servers used by Service Mapping.
File System To Storage Path

[sa_storage_paths]

Contains data on storage paths discovered by Service Mapping.
Storage Path Connectivity Map

[sa_storage_path_connectivity_map]

Maps file system to storage volume.
Traffic Based Discovery Rules

[sa_traffic_based_rules]

Contains data on configuration of traffic-based discovery.
Uploaded File

[sa_uploaded_file]

Contains data on files uploaded to the MID Server and used by Service Mapping.
Configuration Item

[cmdb_ci]

Stores data on all configuration items (CIs) in the CMDB.
Application

[cmdb_ci_appl]

Stores data on all configuration items (CIs) of application type in the CMDB.
IP Service

[cmdb_ip_service]

Stores data for credentialless discovery support for the original table.
Application Category

[discovery_category_appl]

Stores data on application categories used by Pattern Designer for managing pattern libraries.
Device Classification Category

[discovery_category_device_class]

Stores information on relationship between a device classifier and protocol used during horizontal discovery performed by Discovery.
Device Info Category

[discovery_category_device_info]

Stores information on device category used during horizontal discovery performed by Discovery.
Protocol Category

[discovery_category_protocol]

Stores information on protocol category used during horizontal discovery performed by Discovery.
HTTP Classification

[discovery_classy_http]

Stores the HTTP classification definition.
HTTP Classification Match

[discovery_classy_http_match]

Stores the HTTP classification conditions and the information about the pattern to launch if classification condition is matched.
Discovery Pattern Launcher

[discovery_pattern_launcher]

Stores information about the pattern launcher mechanism.
Cloud Execution Pattern

[discovery_ptrn_cld_lchr]

Stores information about the pattern launcher mechanism for discovering cloud applications.
Serverless Execution Pattern

[discovery_ptrn_hostless_lchr]

Stores information about the pattern launcher mechanism for serverless discovery.
Discovery Pattern Parameters

[discovery_ptrn_lnch_param]

Stores parameters for serverless/cloud application execution.
Pattern Input Parameters

[discovery_ptrn_lnch_param_def]

Stores the key parameters collected by patterns.
Applicative Credentials

[sa_applicative_credentials]

Stores the applicative credentials.
Related CI Types

[sa_ci_to_pattern]

Stores related CIs within patterns.
Custom operation

[sa_custom_operation]

Stores information on discovery pattern operations defined by users.
Custom operation parameters

[sa_custom_operation_param]

Stores custom operation parameters for discovery patterns.
Custom parsing strategy

[sa_custom_parsing_strategy]

Stores information on pattern parsing strategies that are defined by users.
Debug session

[sa_debug_session]

Stores information collected from debug sessions.
Pattern Debugger Session Status for UI

[sa_debug_session_status]

Stores information on status of the debug session for the UI purposes.
Sa Deferred Service Discovery

[sa_deferred_service_discovery]

Contains information used for starting the top-down debug session when the relevant host is still not discovered.
Discovery log

[sa_discovery_log]

The log of several discoveries.
Find Host Scripts

[sa_find_host_scripts]

Contains scripts for finding hosts in the CMDB based on the entry point information.
Host Class to Capability

[sa_host_class_to_capability]

Contains information that maps the type of host to MID Server capabilities. For example, the Linux OS is mapped to the SSH WMI capability.
Mapping Discovery Commands

[sa_mapping_ext_commands]

Contains customizable operations for the Pattern Designer.
Horizontal Discovered Paged Payloads

[sa_paged_payload]

Contains the IE output payload if the split mechanism is deployed.
Discovery Patterns

[sa_pattern]

Stores published patterns.
Service Mapping Draft Pattern

[sa_pattern_draft]

Stores modified version of patterns.
Pattern Extensions

[sa_pattern_extension]

Stores pattern extension sections.
Pattern Pre/Post Script

[sa_pattern_prepost_script]

Stores pre/post/pre execution scripts for patterns.
Horizontal Discovered Payloads Snapshot

[sa_payload_snapshot]

Stores the IE output payload for the delete per main CI.
Tracked File Definition

[sa_tracked_file_definition]

Stores the definitions of the file tracking feature.
Uploaded File

[sa_uploaded_file]

Stores scripts and files that are used by the pattern engine.

Properties installed

Note: To open the System Property [sys_properties] table, enter sys_properties.list in the navigation filter.
Property Description
sa.storage_path_calculation.active Enable storage path calculation.
  • Type: true/false
  • Default value: true
  • Other possible values: false
  • Location: Service Mapping > Administration > Properties.
sa.update_paths_in_service_model.active Update network and storage paths in Service Model.
  • Type: true/false
  • Default value: true
  • Other possible values: false
  • Location: Service Mapping > Administration > Properties.
sa.network_path_calculation.active Enable network path calculation.
  • Type: true/false
  • Default value: true
  • Other possible values: false
  • Location: Service Mapping > Administration > Properties.
sa.discovery_task_timeout_min Maximum time for a Service Mapping task in minutes (including waiting for execution in internal queues and ECC queue).
  • Type: string
  • Default value: 120
  • Other possible values: any number higher than 30
  • Location: System Property [sys_properties] table
sa.debugger.max_timeout Maximum timeout (in seconds) since the last server activity during a Pattern Debugger run.
  • Type: integer
  • Default value: 120
  • Other possible values: any number higher than 60
  • Location: Service Mapping > Administration > Properties.
sa.service_history.max_allowed_bubbles Number of changes that the history scale and the Changes tab display.
  • Type: integer
  • Default value: 3000
  • Other possible values: any number higher than 3000
    Attention: Increasing the value for this property may cause performance issues with loading application service maps.
  • Location: Service Mapping > Administration > Properties.
sa.rediscovery.batch_size Number of discovery tasks executed in a single batch.
  • Type: integer
  • Default value: 100
  • Other possible values: any number higher than 10
  • Location: Service Mapping > Administration > Properties.
sa.traffic_based_discovery.active Traffic-based discovery
  • Type: true/false
  • Default value: true
  • Other possible values: false
  • Location: Service Mapping > Administration > Properties.
sa.traffic_based_discovery.conn_aging_time Time period in hours for a Traffic Based Connection to remain active since last discovered.
  • Type: integer
  • Default value: 72
  • Other possible values: any number higher than 24
  • Location: Service Mapping > Administration > Properties.
sa.traffic_based_discovery.ignored_ports Ports to ignore when found by traffic-based discovery.

This property is available in the System Property [sys_properties] table.

Change this property to define ports that Service Mapping ignores while performing traffic-based discovery. It makes discovery more efficient since resources are not wasted on discovering irrelevant connections.

  • Type: string
  • Default value: 445, 139, 111, 2049, 860, 3260, 135, 53
  • Other possible values: any relevant port numbers
  • Location: System Property [sys_properties] table
sa.traffic_based_discovery.max_connections Maximum number of traffic-based connections from a single CI.

This property is available in the System Property [sys_properties] table.

This property helps to keep the map size reasonable by limiting the number of possible CI connections.

  • Type: integer
  • Default value: 30
  • Other possible values: any number higher than 1
  • Location: System Property [sys_properties] table
best_practice.import_csv.max_file_size_in_kb Maximal size of CSV files in KB.

This property is used for importing application service candidates in bulk.

  • Type: integer
  • Default value: 5000
  • Other possible values: any number higher than 1
  • Location: Service Mapping > Service Planner > Properties > .
glide.ui.sa_dw_business_service_activity.fields Defines which fields are displayed for the activity feed in the Planner feature.
  • Type: string
  • Default value: *Attachments*, name, work_notes, *Email*, status, Business_service_owner
  • Other possible values: comma-separated list of fields
  • Location: System Property [sys_properties] table
sa.enable_gray_out_on_resume_discovery Enable sub-tree to be grayed out after Service Mapping resumes discovery on an edge, or rerun discovery on the entire topology.
  • Type: boolean
  • Default value: true
  • Other possible values: false
  • Location: System Property [sys_properties] table
glide.service_mapping.computation_depth

This property controls the maximal depth of the application service map.

  • Type: integer
  • Default value: 25
  • Other possible values: any number higher than 1
  • Location: System Property [sys_properties] table
best_practice.import_csv.max_lines Maximal number of lines in the CSV file used to import entry points.
  • Type: integer
  • Default value: 10000
  • Other possible values: any number higher than 1
  • Location: Service Mapping > Service Planner > Properties > .
best_practice.check_connectivity.expand_listening_port This property controls which PIDs Service Mapping checks during the hop operation in the connectivity check. This property is true, then Service Mapping only checks connectivity on PIDs whose ports are in the listening state, not connected.
  • Type: boolean
  • Default value: true
  • Other possible values: false
  • Location: System Property [sys_properties] table
sa.map.enable_loops_on_service_split Enable you to connect a application service to another, already existing, application service even if the CI connection (endpoint) that you are connecting is part of this other application service. This property helps to avoid loops or cycles in service maps.
  • Type: boolean
  • Default value: false
  • Other possible values: true
  • Location: Service Mapping > Administration > Properties > .
best_practice.check_connectivity.blacklist_ips Blacklist of IP addresses to expand to in the Connectivity Checks feature.
  • Type: string
  • Default value: 127.0.0.1, 127.0.0.2
  • Other possible values: comma-separated list of IP addresses
  • Location: Service Mapping > Service Planner > Properties > .
best_practice.check_connectivity.blacklist_ports Blacklist of ports to expand to in the connectivity checks feature.
  • Type: string
  • Default value: [empty]
  • Other possible values: comma-separated list of ports
  • Location: Service Mapping > Service Planner > Properties > .
best_practice.check_connectivity.max_ips The maximum number of IP addresses to process during the connectivity check.
  • Type: integer
  • Default value: 100
  • Other possible values: any number higher than 1
  • Location: Service Mapping > Service Planner > Properties > .
service_watch.implied_match.endpoint.black_list A list of endpoint types for which Service Mapping does not apply process matching logic utilized during the top-down pattern execution.
  • Type: string
  • Default value: cmdb_ci_endpoint_ssis_mssql, cmdb_ci_endpoint_ssas_mssql
  • Other possible values: comma-separated list of endpoints
  • Location: System Property [sys_properties] table
Feedback