Skip to content

Commit

Permalink
Merge pull request #1648 from splunk/repo-sync
Browse files Browse the repository at this point in the history
Pulling refs/heads/main into main
  • Loading branch information
aurbiztondo-splunk authored Jan 16, 2025
2 parents 93151aa + 47ce587 commit 4445911
Show file tree
Hide file tree
Showing 5 changed files with 79 additions and 95 deletions.
6 changes: 3 additions & 3 deletions _includes/requirements/collector-windows.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ The Collector supports the following Windows versions, depending on the installa
* - Install method
- Supported versions (64-bit)
* - Installer script
- Windows 10 Pro and Home, Windows Server 2016, 2019, 2022
- Windows 10 Pro and Home, Windows Server 2016, 2019, 2022, 2025
* - Windows installer (MSI)
- Windows 10 Pro and Home, Windows Server 2016, 2019, 2022
- Windows 10 Pro and Home, Windows Server 2016, 2019, 2022, 2025
* - Ansible
- Windows 10 Pro and Home, Windows Server 2016, 2019, 2022
- Windows 10 Pro and Home, Windows Server 2016, 2019, 2022, 2025
* - Chef
- Windows 10 Pro and Home, Windows Server 2019, 2022
* - Nomad
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ Currently, the following Windows versions are supported:
* Windows Server 2016 64-bit
* Windows Server 2019 64-bit
* Windows Server 2022 64-bit
* Windows Server 2025 64-bit

Requirements
==========================================
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ The following Windows versions. All versions require using PowerShell 3.0 or new

* Windows Server 2019 64-bit
* Windows Server 2022 64-bit
* Windows Server 2025 64-bit

.. caution:: On Windows, the Collector is installed as a Windows service and its environment variables are set at the service scope, so they're only available to the Collector service and not to the entire machine.

Expand Down
7 changes: 0 additions & 7 deletions metrics-and-metadata/relatedcontent.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,13 +35,6 @@ In the preceding example, the user navigates through the following sequence:
.. note:: Related Content is different from data links, a separate capability, which lets you dynamically transfer contextual information about the property you're viewing to the resource, helping you get to relevant information faster. To learn more about data links, see :ref:`apm-create-data-links`.


Related logs in APM
-----------------------------------------------------------------
For Unified Identity and Log Observer Connect customers, Splunk APM does not show related logs in the Related Content bar by default in order to save resources. To activate Related Content for logs in APM, an administrator must go to :strong:`Settings` then select :strong:`General Settings`. Switch the toggle, :strong:`Activate Related Content for logs` to active.

If you want to save resources by deactivating Related Content for logs in APM, go to :strong:`Settings`, select :strong:`General Settings`,and switch the toggle, :strong:`Activate Related Content for logs` to inactive.


Where can I see Related Content?
-----------------------------------------------------------------

Expand Down
159 changes: 74 additions & 85 deletions synthetics/test-config/private-locations.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
.. _private-locations:

*****************
***************************
Private locations
*****************
***************************

.. meta::
:description: Run synthetic tests from private locations such as internal sites, private web applications, or private networks.
Expand All @@ -23,19 +23,79 @@ To summarize, here are sample use cases for private locations:
* Test from locations not currently supported by Splunk Synthetic Monitoring's public locations.


What is a private runner?
================================
Set up a new private location
=====================================

Follow these steps to set up a new private location:

1. In Splunk Synthetic Monitoring, select the settings gear icon, then :guilabel:`Private locations`.
2. Select :guilabel:`+ Add` and add a name.
3. Follow the steps in the guided setup to set up one or more private runners for that private location.
4. Save your private location.

A private runner is a Docker image which you deploy on your own infrastructure, within your own internal network. It picks up test runs from the queue of tests assigned to its associated private location, performs the actions in the test run on the test target, and reports the results back to Splunk Synthetic Monitoring.

What you can do with your private location ID
------------------------------------------------------------

If you create multiple private runners for a private location, they can process that location's test queue faster. Splunk Synthetic Monitoring doesn't track how many private runners there are for a given private location. It's up to you to manage your own fleet of private runners.
Each private location has a corresponding private location ID. With this ID, you can:

* Build charts or dashboards
* Search for metrics by private location
* Refer to your private location ID if you're interacting with the Splunk Synthetics Monitoring APIs.

Requirements for private runners
==========================================
Manage your tokens
--------------------------------
It is your responsibility to update and manage your tokens. Tokens are valid for one year. For added security, create a secret environment variable for your token in Docker. Consider creating a second token to provide coverage before your first token expires. You are not notified of expiring tokens.

Assess the health of a private location
---------------------------------------------------------

A private location's health depends on three factors:

.. list-table::
:header-rows: 1
:widths: 20 40 40

* - :strong:`Factor`
- :strong:`Description`
- :strong:`Solution`
* - Active runner
- At least one runner is actively checking in.
- If no runners are checking in, set up new runners for the private location.
* - Used in tests
- The private location is currently being used in one or more tests.
- If you need to delete a private location, you need to first delete it from all tests.
* - Clear queue
- The queue for a given location is being cleared periodically and is not backed up.
- If the queue is backed up, add new runners to the private location.


Troubleshoot queue length and latency
---------------------------------------------------

If both the queue latency and length increase over time, then add more runners to improve performance.

If your queue latency increases but your queue length doesn't, try these troubleshooting methods:

* Check to see if a step is delaying the rest of the test.
* Investigate whether you have the sufficient resources to run private location runners on your machines.

The maximum number of runs in a queue is 100,000.

Any runs older than one hour are removed from the queue.


Private runners
=====================================

A private runner queries Splunk Synthetic Monitoring for tests configured to run in its inherent private location, performs the test's steps on your private target, and reports the results back to Splunk Synthetic Monitoring. Because a private runner must have access to your private target, it is a Docker image which you deploy on your own infrastructure, within your own internal network. See :ref:`private-locations`.

If you deploy multiple private runners on behalf of a single private location, they can process that location's test queue faster. Splunk Synthetic Monitoring doesn't track how many private runners you've deployed for a given private location. It's up to you to manage your own fleet of private runners.


Requirements for private runners
-------------------------------------

.. list-table::
:header-rows: 1
:widths: 20 80
Expand Down Expand Up @@ -64,39 +124,10 @@ For optimal performance when running browser tests:
* 8 GB RAM, 2 cores


Set up a new private location
=====================================

Follow these steps to set up a new private location:

1. In Splunk Synthetic Monitoring, select the settings gear icon, then :guilabel:`Private locations`.
2. Select :guilabel:`+ Add` and add a name.
3. Follow the steps in the guided setup to set up one or more private runners for that private location.
4. Save your private location.


What you can do with your private location ID
------------------------------------------------------------

Each private location has a corresponding private location ID. With this ID, you can:

* Build charts or dashboards
* Search for metrics by private location
* Refer to your private location ID if you're interacting with the Splunk Synthetics Monitoring APIs.

Manage your tokens
--------------------
It is your responsibility to update and manage your tokens. Tokens are valid for one year. For added security, create a secret environment variable for your token in Docker. Consider creating a second token to provide coverage before your first token expires. You are not notified of expiring tokens.


Working with Docker
======================================
Here is some guidance for working with Docker.

Limit logging in Docker
------------------------------------
-------------------------------------

Follow these steps to limit logging:
Follow these steps to limit logging in Docker:

#. Create a file in a directory like this: ``/etc/docker/daemon.json``.

Expand All @@ -115,9 +146,9 @@ Follow these steps to limit logging:
#. Restart your docker service: ``sudo systemctl docker.service restart``.


Add certificates
-------------------------------------

Add certificates in Synthetics
------------------------------------------------------
Splunk Synthetic Monitoring supports injecting custom root CA certificates for Uptime tests running from your private locations. Client keys and certificates aren't supported at this time.

#. Create a folder called ``certs`` on your host machine and place the CA Certificate (in CRT format) in the folder.
Expand All @@ -137,12 +168,8 @@ For example, here is what a command might look like after you modify it to fit y
.. Note:: Custom root CA certificates aren't supported for Browser tests. Browser tests require SSL/TLS validation for accurate testing. Optionally, you can deactivate SSL/TLS validation for Browser tests when necessary.






Configure proxy settings for a private location
===================================================
Configure proxy settings for a private runner
---------------------------------------------------------

In environments where direct internet access is restricted, you can route synthetic test traffic through a proxy server by configuring the following environment variables:

Expand Down Expand Up @@ -193,41 +220,3 @@ When using a private runner, it's important to correctly configure the proxy set
.. note::
Lower case variable names take precedence and are best practice.


Assess the health of a private location
==============================================

A private location's health depends on three factors:

.. list-table::
:header-rows: 1
:widths: 20 40 40

* - :strong:`Factor`
- :strong:`Description`
- :strong:`Solution`
* - Active runner
- At least one runner is actively checking in.
- If no runners are checking in, set up new runners for the private location.
* - Used in tests
- The private location is currently being used in one or more tests.
- If you need to delete a private location, you need to first delete it from all tests.
* - Clear queue
- The queue for a given location is being cleared periodically and is not backed up.
- If the queue is backed up, add new runners to the private location.

Troubleshoot queue length and latency
---------------------------------------------------

If both the queue latency and length increase over time, then add more runners to improve performance.

If your queue latency increases but your queue length doesn't, then try these troubleshooting methods:

* Check to see if a step is delaying the rest of the test
* Investigate whether you have the sufficient resources to run private location runners on your machines.

The maximum number of runs in a queue is 100,000.

Any runs older than one hour are removed from the queue.


0 comments on commit 4445911

Please sign in to comment.