Documentation forServer & Application Monitor

Import and export SAM templates

SAM integrates with the SolarWinds online IT community site, THWACK, so you can download the latest updates to SAM templates, download custom templates created by other SAM customers, and share templates that may be useful to other customers.

SolarWinds recommends that you check THWACK periodically for updates to SAM's out-of-the-box (OOTB) templates. Except forAppInsight templates, templates are not updated automatically during upgrades to avoid overwriting custom changes made to existing templates. Official updates to OOTB templates posted on THWACK are attributed to solarwinds_worldwide_llc.

When working with THWACK templates, note the following details:

  • To import templates from THWACK or post templates on THWACK, you'll need a THWACK account. To create one, navigate to https://thwack.solarwinds.com.
  • You cannot import or export AppInsight templates.
  • SolarWinds posts SAM templates under development to get customer feedback. While SolarWinds Support does not provide direct support for yet-to-be-released templates, product owners monitor THWACK posts to answer questions and evaluate input.
  • SolarWinds does not provide direct support for templates posted on THWACK by third parties. If you have questions or suggestions for material posted by a THWACK member, use the forum's built-in messaging functionality.

Disclaimer: Any custom templates, scripts or other content posted in THWACK are provided as a suggestion or recommendation for your internal use. This is not part of the SolarWinds software purchased from SolarWinds, and the information set forth herein may come from third party customers. Your organization should internally review and assess to what extent, if any, such custom templates or scripts will be incorporated into your environment. Any custom content obtained on THWACK is provided to you “AS IS” without indemnification, support, or warranty of any kind, express or implied. You elect to utilize custom templates or scripts at your own risk, and you will be solely responsible for the incorporation of the same, if any.

Import templates

There are several ways to import templates:

  • Navigate to the Manage Templates page > Shared Templates in THWACK tab and import templates, or
  • Download template files to your local drive and then import them into SAM.

Note the following details about importing templates:

  • Before updating existing templates:
    • Create backup copies of existing templates to save any custom changes that occurred.
    • Ensure the imported file format is XML with an .apm-template extension.
    • Unzip templates before importing.
  • Official SAM templates posted on THWACK are attributed to solarwinds_worldwide_llc.
  • To learn about accessing THWACK templates via a proxy, click here.
  • If an imported template name matches an existing template, the name is appended with n automatically, where n is an integer.

Watch a THWACK Tuesday Tips video about importing templates from THWACK, "How to Import an Application Template and Assign to a Node."

To import a SAM template from THWACK:

  1. Click Settings > All Settings > SAM Settings > Manage Templates.
  2. Switch to the Shared Templates on THWACK tab.
  3. Locate and select the template you want to import and then click Import.
  4. Enter your THWACK credentials, and then click Log In.
  5. When the confirmation message appears, click View Imported Templates or Close.

To import a SAM template from a file on a local drive:

If a template is in a ZIP file on your local drive, extract the file and verify it is in XML format with the following extension: .apm-template. Otherwise, you'll receive an Invalid File error.

  1. Click Settings > All Settings > SAM Settings, and click Manage Templates.
  2. Click Import/Export, and click Import.
  3. Browse and select the template file from your local drive.
  4. Click Submit.
    After verifying the file type and format, SAM imports the template.

Export a template

Note the following details about exporting templates to THWACK:

  • Templates are exported in XML format with a .apm-template extension.
  • Exported templates are added to the template repository accessed by SAM, as displayed on the Shared Templates on THWACK tab of the Manage Templates page.
  • Templates may take several minutes to export, depending on how many you're exporting.

To export a SAM template:

  1. Click Settings > All Settings > SAM Settings > Manage Templates.
  2. On the Application Monitor Templates, tab, select the template(s) to export.
  3. Click Import/Export > Export to THWACK.

    1. Enter your THWACK credentials, and then click Log In.

    2. Click Close on the confirmation message that appears.
  4. To share the template in THWACK, navigate to the Application Monitor Templates folder on THWACK.
  5. Click Write a document, add a title and description, and attach the .apm-template file.
  6. Add apm_monitoring_template in the Tags field.
  7. Select Application Monitor Templates in Categories.
  8. Click Publish to post the information and template.

To add descriptive text to your template post, click your Profile picture in the top of THWACK and click Your Content. On the All Content tab, select the row for your template post and click Edit.