Components installed with Service Mapping
- UpdatedJan 30, 2025
- 17 minutes to read
- Yokohama
- 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 service instances, creates service groups, views, and edits service instance maps. |
[itil] |
[app_service_user] | Views maps for operational service instances and retrieves service content using the getContent - GET REST API. The itil role that serves as the basic helpdesk technician role contains the app_service_user role. |
[cmdb_read] |
[itom_admin] | Configure IT Operations Management 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] |
[service_mapping_admin] | Sets up the Service Mapping application. Maps, fixes, and maintains service instances. Also performs advanced configuration and customization of the product. Assign this role to application administrators. |
|
[sm_app_owner] | Provides information necessary for successful mapping of a service instance. 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 service instances and are familiar with the infrastructure and applications that make up the services. |
[service_mapping_user] |
[sm_itom_license.reader] | Views subscription information and statistics for IT Operations Management applications. | [cmdb_read] |
[service_mapping_user] | Views maps for operational service instances to plan change or migration, as well as analyze the continuity and availability of services. Assign this role to application users. |
|
[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 App 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 service instance contains. |
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. This scheduled job is disabled by default. Enable this scheduled job to discover CIs using Netflow as described in Data collection and discovery using Netflow. |
Generate entry point candidates from netflow and netstat data [sysauto_script_b0b95067c3d0030039a3553a81d3aeb5] | Runs daily. Scans the TCP Connection [cmdb_tcp] table and uses this data to generate entry points and store them in the Candidate Entry Points [sa_cand_entry_point] table. This scheduled job supports generating entry points necessary for mapping multiple application services (in bulk). This scheduled job is enabled by default. |
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. |
[sm dedup tracker for specific discovery sources] | In some cases, Service Mapping and third-party discovery or monitoring tools identify the same configuration item (CI) differently. It results in the CMDB application table containing two records for the same CI. This scheduled job scans the CMDB application tables that contain information about CIs identified as generic applications. If the scheduled job identifies duplicate records based on the CI type and the discovery source, it creates a deduplication task. |
[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. |
[sys_auto_flush_41d9b007b71310105984eb25de11a96e] | Cleans the Connection Suggestion [sa_ml_connection_suggestion] table from the
old records that match the following conditions:
|
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. |
Dynamic CI Group [cmdb_ci_query_based_service] |
Contains technical services. |
Components [sa_bs_components] |
Contains information on components that are part of the service instance. Customers enter this information manually in the Questionnaire tab of the service instance 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. |
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. |
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. |
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
Property | Description |
---|---|
sa.max_relations_in_service | The maximum number of CI relations for a service. Exceeding the value
automatically prohibits some services from displaying in the map view. Very large
application services may cause performance issues. Instead of maps, users can view
CI lists for large application services.
|
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.
|
com.snc.sw.mapping.reaper.checkpoints_to_keep | The maximum number of change marks maintained in the history timeline of the
service. Setting the value to zero or any negative integer overrides the default
setting and maintains all change marks for a three-month maximum. Using the
property 'com.snc.sw.mapping.reaper.ignored_services_from_optimization' allows the
exclusion of specific services and returns to the removal of change marks based
upon intervals.
|
com.snc.sw.mapping.reaper.ignored_services_from_optimization | This property contains the service IDs separated by commas. Instead of the
number specified by the property 'com.snc.sw.mapping.reaper.checkpoints_to_keep'
these services retain all change marks for a three-month maximum.
Type: integer |
com.snc.sw.mapping.reaper.max_reap_size | The maximum number of change marks deleted each time the system removes old
and unused records from the history of changes to the service. Setting the value
to zero or any negative integer overrides the limit and allows the removal of all
unnecessary change marks.
|
glide.service_mapping.computation_depth | This property controls the maximal depth of the service instance map.
|
sa_ml.connection_suggestions.active | Enable generation of the connection suggestions feature that is based on
traffic-based discovery. Service Mapping generates connection
suggestions using data analyzed by Predictive Intelligence. When this
feature is enabled, you can use connection
suggestions to manage CI connections in application services.
|
sa.debugger.max_timeout | Maximum timeout (in seconds) since the last server activity during a Pattern Debugger run.
|
sa.discovery_task_timeout_min | Maximum time for a Service Mapping task in minutes (including
waiting for execution in internal queues and ECC queue).
|
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.
|
sa.excluded_discovery_sources | Add this property to exclude discovery sources during host detection.
|
sa.map.enable_loops_on_service_split | Enable you to connect a service instance to another, already existing, service instance even if the CI connection (endpoint) that you are connecting is part of this other service instance. This property helps to avoid loops or cycles in service maps.
|
sa_ml.connection_suggestions.lb.routing.enabled | State if a target host is a load balancer member or not in the Connection Suggestions list.
|
sa.network_path_calculation.arp_enableadded per DOC 1074513 in Vancouver | Controls queries to the ARP table. Data is only calculated when the value is set to true. Note: For more information about querying the ARP table, see the ARP property documentation for Service Mapping [KB1311037] article in the Now Support Knowledge Base.
|
sa.network_path_calculation.active | Enable network path calculation.
|
sa.rediscovery.batch_size | Number of discovery tasks executed in a single batch.
|
sa.service_history.max_allowed_bubbles | Number of changes that the history scale and the Changes tab display.
|
sa.service.max_ci_service_population | The maximum number of CI connections added to application services during the following operations: Converting manual services created in Event Management into application services with changes from the CMDB.
|
sa.storage_path_calculation.active | Enable storage path calculation.
|
sa.topdown.mapping_with_acc_mode |
This property enables top-down discovery and service mapping using
Agent Client Collector by defining the MID Server selection mode for top-down discovery.
0: Top-down discovery runs using the MID Server exclusively. 1: Top-down discovery initially attempts to run using Agent Client Collector. If no agent is available, then it defaults to using the MID Server. 2: Top-down discovery runs using Agent Client Collector exclusively. If unsuccessful, the process terminates. |
sa.traffic_based_discovery.active | Traffic-based discovery
Note: This property applies only to legacy traffic-based connections. If machine-learning (ML) connection suggestions are enabled, ensure that the property value remains set to
false.
|
sa.traffic_based_discovery.conn_aging_time | Time period in hours for a Traffic Based Connection to remain active since last discovered.
|
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.
|
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.
|
sa.update_paths_in_service_model.active | Update network and storage paths in Service Model.
|
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.
|
sm.service.export.blacklist | Excludes these fields from the record in the service definition export
file.
|
sm.service.export.blacklist.cmdb_ci_endpoint | Excludes these fields from the entry point record in the service definition
export file.
|
sm.service.export.blacklist.cmdb_ci_service_discovered | Excludes these fields from the application service record in the service
definition export file.
|
sm.service.export.blacklist.cmdb_ci_service_group | Excludes these fields from the service group record in the service definition
export file. Use comma to separate fields.
|
sm.service.export.max_services_limit | Defines the maximum allowed number of services to export.
|
sm.service.export.skip_empty_fields | Excludes fields with an empty value from the record in the service
definitions export file.
|
sm.service.export.skip_reference_fields | Excludes reference fields from the record in the service definitions export
file.
|
sm.service.export.skip_sys_fields | Excludes fields beginning with “sys_” from the record in the service
definitions export file.
|
sm.service.import.auto_start_discovery | Enable automatic discovery on all successfully imported entry points.
|
sn_cloud_migration.categories.inclusion_list | A comma-separated allow list of categories for cloud migration. Only
resources assigned to categories that are listed here can participate in the
migration process.
|
sn_cloud_migration.server_status.inclusion_list | A comma-separated allow list of server status for cloud migration. Only
servers with the listed here install status can participate in the migration
process.
|
sn_cloud_migration.os.exclusion_list | A comma-separated deny list of operating systems for cloud migration. The
servers whose operating system is listed here are excluded from the migration
process.
|
sn_cloud_migration.vm_state.inclusion_list | A comma-separated allow list of VM instance states for cloud migration. Only
VMs with states that are listed here can participate in the migration process.
|
The number of CI relations, exceeding which application service is not
displayed automatically in the map view. Very large application services may cause
performance issues. Instead of maps, users can view CI lists for large application
services. Setting a negative value results in not limiting the number of added CI
relations. Setting an invalid value, like a string, is equivalent to the default
value, 5000.
|
|
svc_by_tags.classes.whitelist | This property contains the list of allowed CI classes separated by commas. Tag-based mapping includes the CIs belonging to these classes. An empty ‘value’ field indicates the inclusion of all CI classes. |
svc_by_tags.install_status.blacklist | This property contains the list of exclusions based upon the install status separated by commas. Tag-based mapping excludes any tagged CIs with the following install statuses: Default value: 7,100 Other possible values: Installed=1, On order=2, In maintenance=3, Pending install=4, Pending repair=5, In stock=6, Retired=7, Stolen=8 |
svc_by_tags.max.categories.per.family | Set the maximum number of categories allowed per service family.
|
svc_by_tags.max.traversal.rules.active | Set the maximum allowed number of CI relationships that can be in the active
state. Service Mapping uses only active CI relationships for
tag-based discovery.
|
svc_by_tags.max_ci_limit | Set the maximum allowed number of CIs that a tag-based application service
can contain.
|
sm.topdown.reuse_mid_from_hd_schedule | Use the MID Server configured during horizontal discovery for top-down discovery.
|
sm.network_location.detect_host_by_location | Select the subnetwork location to allow for the identification of the appropriate host and MID Server. Important: For best results, you must enable this property and sm.topdown.reuse_mid_from_hd_schedule concurrently.
|