Partner App Template

tip

Copy this file and edit it for your App integration.

(Introduction about the app)

\Add the description from the app description above\

Log types and metrics

The {AppName} App uses...

\Enter a list of log types, usually hyperlinked to vendor docs.\

Sample log and metrics messages

Log message

Log message

\<add your log message here\>

Metric message

Metric message

\<add your log message here\>

Sample queries

Log query

Log query

\<add your query here\>

Metric query

Metric query

\<add your query here\>

Prerequisites (Optional)

\Any steps like permissions or roles that the user should have for configuring the collection steps.\

Collection configuration and app installation

\This section instructions for collecting logs, metrics, or logs and metrics. You can also give link to collection docs if they are hosted publicly. Include a diagram, as appropriate. For an example, see Collection process for GCP services.\

Step 1.

\step description\

Step 2.

\step description\

Step n.

\step description\

Install the {AppName} app

To install the app:

1. Select App Catalog.
2. In the 🔎 Search Apps field, run a search for your desired app, then select it.
3. Click Install App.
   note

   Sometimes this button says Add Integration.

4. On the next configuration page, under Select Data Source for your App, complete the following fields:
   • Data Source. Select one of the following options:
     • Choose Source Category and select a source category from the list; or
     • Choose Enter a Custom Data Filter, and enter a custom source category beginning with an underscore. For example, _sourceCategory=MyCategory.
   • Folder Name. You can retain the existing name or enter a custom name of your choice for the app.
   • All Folders (optional). The default location is the Personal folder in your Library. If desired, you can choose a different location and/or click New Folder to add it to a new folder.
5. Click Next.
6. Look for the dialog confirming that your app was installed successfully.
   

Post-installation

Once your app is installed, it will appear in your Personal folder or the folder that you specified. From here, you can share it with other users in your organization. Dashboard panels will automatically start to fill with data matching the time range query received since you created the panel. Results won't be available immediately, but within about 20 minutes, you'll see completed graphs and maps.

Viewing the {AppName} dashboards

All dashboards have a set of filters that you can apply to the entire dashboard. Use these filters to drill down and examine the data to a granular level.

• You can change the time range for a dashboard or panel by selecting a predefined interval from a drop-down list, choosing a recently used time range, or specifying custom dates and times. Learn more.
• If required, configure the refresh interval rate for a dashboard or panel by clicking the drop-down arrow next to the refresh icon.
• Click the funnel icon in the dashboard top menu bar to filter dashboard with Template Variables.
  

Dashboard 1

\Descriptions of each app dashboard.
\This section has dashboard description, use cases, and screenshot for each dashboard.\

The Overview Dashboard provides a quick snapshot of ....

Use this dashboard to:

• \use-case-1\
• \use-case-2\

Dashboard 2

View stats and metrics related to ...

Use this dashboard to:

• \use-case-1\
• \use-case-2\

Support

This application has been developed and is supported by {app-owner-name}. In case of any technical queries, contact support at support contact.