Splunk® Add-on Builder

Splunk Add-on Builder User Guide

Download manual as PDF

Download topic as PDF

Create a setup page

Creating a setup page for your add-on lets users provide information needed to run your add-on without having to edit a configuration file directly. Create a setup page that appears to users when they run your add-on. Use a setup page when:

  • Your add-on requires setup parameters.
  • You need to authenticate users with a username and password, for example to authenticate a third-party API for a data input.
  • You need the user to provide proxy information, for example when you need to use a proxy to make outbound API calls from the add-on.

Add a setup page to your add-on

The Add-on Builder provides a wizard that walks you through the process of creating a setup page and includes the following steps:

Create the setup page

The Add-on Builder wizard includes an Add-on Setup Parameters tab where you create or edit the setup page for an add-on. Select predefined setup options and define custom text, password, and checkbox inputs.
Setup parameters can be used in any data input or alert action within the add-on.
You can use the following setup parameters when you create your setup page.
    Setup parameter Usage
    Global account settings Adds a predefined Account tab to the add-on's Configuration page that allows the user to configure multiple accounts, such as one account for production and one for development.

    This Global account setting option is selected automatically when you add a Global Account field as a data input parameter.

    Proxy settings Adds a predefined Proxy tab to the add-on's Configuration page that allows the user to specify a proxy host, port, username, password, and type.
    Logging settings Adds a predefined Logging tab to the add-on's Configuration page that lets the user select the logging level to use for the add-on.
    Text field

    Password field
    Checkbox field

    Drag and drop different types of inputs from the Component Library to the setup form. These options are displayed on a separate Add-on Settings tab on the add-on's Configuration page. Password fields are automatically obfuscated using the storage password endpoint.

Test the setup page

Test the setup page by entering sample values.

View the production version of the setup page

To access the production version of the add-on's setup page while developing your add-on, open the app in Splunk Web and click Configuration.

For detailed procedures, see:

Last modified on 27 January, 2020
PREVIOUS
Configure data collection using your Python code
  NEXT
Add sample data

This documentation applies to the following versions of Splunk® Add-on Builder: 3.0.0, 3.0.1


Was this documentation topic helpful?

Enter your email address, and someone from the documentation team will respond to you:

Please provide your comments here. Ask a question or make a suggestion.

You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters