Skip to content

Commit bc7d08a

Browse files
reorganize solutions/observability/apm/ files along team lines
1 parent 1014811 commit bc7d08a

File tree

105 files changed

+446
-387
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

105 files changed

+446
-387
lines changed

deploy-manage/deploy/cloud-enterprise/edit-stack-settings-apm.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Starting in {{stack}} version 8.0, how you change APM settings and the settings
1818
: New deployments created in {{stack}} version 8.0 and later will be managed by {{fleet}}.
1919

2020
* This mode requires SSL/TLS configuration. Check [TLS configuration for {{fleet}}-managed mode](#ece-edit-apm-fleet-tls) for details.
21-
* Check [APM integration input settings](/solutions/observability/apm/configure-apm-server.md) for all other Elastic APM configuration options in this mode.
21+
* Check [APM integration input settings](/solutions/observability/apm/apm-server/configure.md) for all other Elastic APM configuration options in this mode.
2222

2323

2424
Standalone APM Server (legacy)
@@ -45,7 +45,7 @@ Pick one of the following options:
4545
{{ece}} supports most of the legacy APM settings. Through a YAML editor in the console, you can append your APM Server properties to the `apm-server.yml` file. Your changes to the configuration file are read on startup.
4646

4747
::::{important}
48-
Be aware that some settings could break your cluster if set incorrectly and that the syntax might change between major versions. Before upgrading, be sure to review the full list of the [latest APM settings and syntax](/solutions/observability/apm/configure-apm-server.md).
48+
Be aware that some settings could break your cluster if set incorrectly and that the syntax might change between major versions. Before upgrading, be sure to review the full list of the [latest APM settings and syntax](/solutions/observability/apm/apm-server/configure.md).
4949
::::
5050

5151

deploy-manage/deploy/cloud-on-k8s/advanced-configuration.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ This section covers the following topics:
2424
APM Agent central configuration was added in 7.5.1.
2525
:::
2626

27-
[APM Agent configuration management](/solutions/observability/apm/apm-agent-central-configuration.md) allows you to configure your APM Agents centrally from the {{kib}} APM app. To use this feature, the APM Server needs to be configured with connection details of the {{kib}} instance. If {{kib}} is managed by ECK, you can simply add a `kibanaRef` attribute to the APM Server specification:
27+
[APM Agent configuration management](/solutions/observability/apm/apm-server/apm-agent-central-configuration.md) allows you to configure your APM Agents centrally from the {{kib}} APM app. To use this feature, the APM Server needs to be configured with connection details of the {{kib}} instance. If {{kib}} is managed by ECK, you can simply add a `kibanaRef` attribute to the APM Server specification:
2828

2929
```yaml subs=true
3030
cat <<EOF | kubectl apply -f -
@@ -112,7 +112,7 @@ The APM Server keystore can be used to store sensitive settings in the APM Serve
112112
password: "${ES_PASSWORD}"
113113
```
114114

115-
3. Reference the key in the APM Server configuration, as described in the [Secrets keystore for secure settings](/solutions/observability/apm/secrets-keystore-for-secure-settings.md).
115+
3. Reference the key in the APM Server configuration, as described in the [Secrets keystore for secure settings](/solutions/observability/apm/apm-server/secrets-keystore-for-secure-settings.md).
116116

117117

118118
## Reference an existing {{es}} cluster [k8s-apm-existing-es]

deploy-manage/deploy/cloud-on-k8s/use-an-elasticsearch-cluster-managed-by-eck.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ products:
1010

1111
# Use an {{es}} cluster managed by ECK [k8s-apm-eck-managed-es]
1212

13-
Managing APM Server, {{kib}} and {{es}} with ECK allows a smooth and secured integration between the stack components. The output configuration of the APM Server is setup automatically to establish a trust relationship with {{es}}. Specifying the {{kib}} reference allows ECK to automatically configure the [{{kib}} endpoint](/solutions/observability/apm/configure-kibana-endpoint.md).
13+
Managing APM Server, {{kib}} and {{es}} with ECK allows a smooth and secured integration between the stack components. The output configuration of the APM Server is setup automatically to establish a trust relationship with {{es}}. Specifying the {{kib}} reference allows ECK to automatically configure the [{{kib}} endpoint](/solutions/observability/apm/apm-server/configure-kibana-endpoint.md).
1414

1515
1. To deploy an APM Server and connect it to the {{es}} cluster and {{kib}} instance you created in [](/deploy-manage/deploy/cloud-on-k8s/elasticsearch-deployment-quickstart.md), apply the following specification:
1616

deploy-manage/deploy/elastic-cloud/differences-from-other-elasticsearch-offerings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,7 @@ This table compares Observability capabilities between {{ech}} deployments and O
109109
|---------|----------------------|-----------------------------------|------------------|
110110
| [**AI Assistant**](/solutions/observability/observability-ai-assistant.md) ||| |
111111
| **APM integration** ||| Use **Managed Intake Service** (supports Elastic APM and OTLP protocols) <br> Refer to [Managed OTLP endpoint](opentelemetry://reference/motlp.md) for OTLP data ingestion |
112-
| [**APM Agent Central Configuration**](/solutions/observability/apm/apm-agent-central-configuration.md) ||| Not available in Serverless |
112+
| [**APM Agent Central Configuration**](/solutions/observability/apm/apm-server/apm-agent-central-configuration.md) ||| Not available in Serverless |
113113
| [**APM Tail-based sampling**](/solutions/observability/apm/transaction-sampling.md#apm-tail-based-sampling) ||| - Not available in Serverless <br>- Consider **OpenTelemetry** tail sampling processor as an alternative |
114114
| [**Android agent/SDK instrumentation**](apm-agent-android://reference/edot-android/index.md) ||| |
115115
| [**AWS Firehose integration**](/solutions/observability/cloud/monitor-amazon-web-services-aws-with-amazon-data-firehose.md) ||| |

deploy-manage/deploy/elastic-cloud/edit-stack-settings.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ For a list of supported settings, check [{{kib}} settings](kibana://reference/cl
4343

4444
### APM settings
4545

46-
Refer to [APM configuration reference](/solutions/observability/apm/configure-apm-server.md) for information on how to configure the {{fleet}}-managed APM integration.
46+
Refer to [APM configuration reference](/solutions/observability/apm/apm-server/configure.md) for information on how to configure the {{fleet}}-managed APM integration.
4747

4848
## Edit settings [ec-add-user-settings]
4949

deploy-manage/deploy/elastic-cloud/switch-from-apm-to-integrations-server-payload.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -405,7 +405,7 @@ From the deployment **APM & Fleet** page you can also:
405405

406406
### Upgrading to {{stack}} 8.0 [ec-upgrade-apm-stack-8]
407407

408-
The following APM settings have been removed in {{stack}} version 8.0. This change is only relevant to users upgrading a standalone (legacy) deployment of APM Server to {{stack}} version 8.0. Check [Add APM user settings](/solutions/observability/apm/configure-apm-server.md) for more details.
408+
The following APM settings have been removed in {{stack}} version 8.0. This change is only relevant to users upgrading a standalone (legacy) deployment of APM Server to {{stack}} version 8.0. Check [Add APM user settings](/solutions/observability/apm/apm-server/configure.md) for more details.
409409

410410
```yaml
411411
apm-server.api_key.enabled

deploy-manage/deploy/self-managed/air-gapped-install.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ To learn more about installing {{fleet-server}}, refer to the [{{fleet-server}}
6969
Air-gapped setup of the APM server is possible in two ways:
7070

7171
* By setting up one of the {{agent}} deployments with an APM integration, as described in [Switch a self-installation to the APM integration](/solutions/observability/apm/switch-self-installation-to-apm-integration.md). See [air gapped installation guidance for {{agent}}](#air-gapped-elastic-agent).
72-
* Or, by installing a standalone Elastic APM Server, as described in the [APM configuration documentation](/solutions/observability/apm/configure-apm-server.md).
72+
* Or, by installing a standalone Elastic APM Server, as described in the [APM configuration documentation](/solutions/observability/apm/apm-server/configure.md).
7373

7474

7575
## {{ems}} [air-gapped-elastic-maps-service]

deploy-manage/monitor/logging-configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ You can also consume logs using [stack monitoring](/deploy-manage/monitor/stack-
111111

112112
You can also collect and index the following types of logs from other components in your deployments:
113113

114-
[**APM**](/solutions/observability/apm/configure-logging.md)
114+
[**APM**](/solutions/observability/apm/apm-server/configure-logging.md)
115115

116116
* `apm*.log*`
117117

deploy-manage/monitor/stack-monitoring.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ Most of these methods require that you configure monitoring of {{es}} before mon
8989
* [Packetbeat](beats://reference/packetbeat/monitoring.md)
9090
* [Winlogbeat](beats://reference/winlogbeat/monitoring.md)
9191

92-
* [**APM Server**](/solutions/observability/apm/monitor-apm-server.md)
92+
* [**APM Server**](/solutions/observability/apm/apm-server/monitor.md)
9393

9494
* **{{agent}}s**:
9595
* [{{fleet}}-managed {{agent}}s](/reference/fleet/monitor-elastic-agent.md)

deploy-manage/security/fips-ingest.md

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
applies_to:
33
deployment: ga
4-
navigation_title:
4+
navigation_title:
55
products:
66
- id: apm
77
- id: elastic-agent
@@ -25,59 +25,59 @@ Generally speaking FIPS 140-2 requirements can be summarized as:
2525
FIPS compatible binaries for {{agent}}, {{fleet}}, {{filebeat}}, {{metricbeat}}, and {{apm-server}} are available for [download](https://www.elastic.co/downloads). Look for the `Linux 64-bit (FIPS)` or `Linux aarch64 (FIPS)` platform option on the product download pages for {{agent}} and {{fleet}}, {{filebeat}}, and {{metricbeat}}. Look for the `Linux x86_64 (FIPS)` or `Linux aarch64 (FIPS)` platform option on the {{apm-server}} download page.
2626

2727
:::{important}
28-
The default configurations provided in the binaries are FIPS compatible. Be sure to check and understand the implications of changing default configurations.
28+
The default configurations provided in the binaries are FIPS compatible. Be sure to check and understand the implications of changing default configurations.
2929
:::
3030

3131
## Limitations [ingest-limitations-all]
3232

3333
### TLS [ingest-limitations-tls]
3434

3535
Only FIPS 140-2 compliant TLS protocols, ciphers, and curve types are allowed to be used as listed below.
36-
* The supported TLS versions are `TLS v1.2` and `TLS v1.3`.
36+
* The supported TLS versions are `TLS v1.2` and `TLS v1.3`.
3737
* The supported cipher suites are:
3838
* `TLS v1.2`: `ECDHE-RSA-AES-128-GCM-SHA256`, `ECDHE-RSA-AES-256-GCM-SHA384`, `ECDHE-ECDSA-AES-128-GCM-SHA256`, `ECDHE-ECDSA-AES-256-GCM-SHA384`
3939
* `TLS v1.3`: `TLS-AES-128-GCM-SHA256`, `TLS-AES-256-GCM-SHA384`
4040
* The supported curve types are `P-256`, `P-384` and `P-521`.
4141

4242
Support for encrypted private keys is not available, as the cryptographic modules used for decrypting password protected keys are not FIPS validated. If an output or any other component with an SSL key that is password protected is configured, the components will fail to load the key. When running in FIPS mode, you must provide non-encrypted keys.
43-
Be sure to enforce security in your FIPS environments through other means, such as strict file permissions and access controls on the key file itself, for example.
43+
Be sure to enforce security in your FIPS environments through other means, such as strict file permissions and access controls on the key file itself, for example.
4444

45-
These TLS related restrictions apply to all components listed--{{agent}}, {{fleet}}, {{filebeat}}, {{metricbeat}}, and {{apm-server}}.
45+
These TLS related restrictions apply to all components listed--{{agent}}, {{fleet}}, {{filebeat}}, {{metricbeat}}, and {{apm-server}}.
4646

4747
### General output and input limitations (Kerberos protocol) [ingest-inputoutput-limitations]
4848

49-
The Kerberos protocol is not supported for any output or input, which also impacts the available `sasl.mechanism` for the Kafka output where only `PLAIN` is supported.
49+
The Kerberos protocol is not supported for any output or input, which also impacts the available `sasl.mechanism` for the Kafka output where only `PLAIN` is supported.
5050

51-
This impacts [Filebeat](beats://reference/filebeat/configuration-kerberos.md), [Metricbeat](beats://reference/metricbeat/configuration-kerberos.md) and {{apm-server}}, as well as output configurations for {{agent}} with {{fleet-server}}.
51+
This impacts [Filebeat](beats://reference/filebeat/configuration-kerberos.md), [Metricbeat](beats://reference/metricbeat/configuration-kerberos.md) and {{apm-server}}, as well as output configurations for {{agent}} with {{fleet-server}}.
5252

5353

5454
### APM Server [ingest-apm-limitations]
5555

56-
* The [Secrets Keystore](/solutions/observability/apm/secrets-keystore-for-secure-settings.md) is not supported.
56+
* The [Secrets Keystore](/solutions/observability/apm/apm-server/secrets-keystore-for-secure-settings.md) is not supported.
5757

5858
### Filebeat [ingest-filebeat-limitations]
5959

60-
* The [Secrets Keystore](beats://reference/filebeat/keystore.md) is not supported.
60+
* The [Secrets Keystore](beats://reference/filebeat/keystore.md) is not supported.
6161
* The [Translate GUID processor](beats://reference/filebeat/processor-translate-guid.md) is not supported.
62-
* The [Fingerprint processor](beats://reference/filebeat/fingerprint.md) does not support the md5 and sha1 method.
63-
* The [Community ID Network Flowhash processor](beats://reference/filebeat/community-id.md) is not supported.
64-
* The [Azure module](beats://reference/filebeat/filebeat-module-azure.md) including the [Azure eventhub input](beats://reference/filebeat/filebeat-input-azure-eventhub.md) and the [Azure Blob Storage Input](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-azure-blob-storage) are not currently supported. The [Add Cloud Metadata processor](beats://reference/filebeat/add-cloud-metadata.md) does not support the Azure Virtual Machine provider currently.
65-
* The [Office 365 module (Beta)](beats://reference/filebeat/filebeat-module-o365.md) and the [Office 365 input (Deprecated)](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-o365audit) are not supported.
66-
* The [GCP Pub/Sub input](beats://reference/filebeat/filebeat-input-gcp-pubsub.md) and the [Google Cloud Storage input](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-gcs) are not supported for now.
67-
* The [Entity Analytics input](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-entity-analytics) is not supported.
62+
* The [Fingerprint processor](beats://reference/filebeat/fingerprint.md) does not support the md5 and sha1 method.
63+
* The [Community ID Network Flowhash processor](beats://reference/filebeat/community-id.md) is not supported.
64+
* The [Azure module](beats://reference/filebeat/filebeat-module-azure.md) including the [Azure eventhub input](beats://reference/filebeat/filebeat-input-azure-eventhub.md) and the [Azure Blob Storage Input](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-azure-blob-storage) are not currently supported. The [Add Cloud Metadata processor](beats://reference/filebeat/add-cloud-metadata.md) does not support the Azure Virtual Machine provider currently.
65+
* The [Office 365 module (Beta)](beats://reference/filebeat/filebeat-module-o365.md) and the [Office 365 input (Deprecated)](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-o365audit) are not supported.
66+
* The [GCP Pub/Sub input](beats://reference/filebeat/filebeat-input-gcp-pubsub.md) and the [Google Cloud Storage input](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-gcs) are not supported for now.
67+
* The [Entity Analytics input](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-input-entity-analytics) is not supported.
6868

6969
### Metricbeat [ingest-metricbeat-limitations]
7070

71-
* The [Secrets Keystore](beats://reference/metricbeat/keystore.md) is not supported.
71+
* The [Secrets Keystore](beats://reference/metricbeat/keystore.md) is not supported.
7272
* The [Translate GUID processor](beats://reference/metricbeat/processor-translate-guid.md) is not supported.
73-
* The [Fingerprint processor](beats://reference/metricbeat/fingerprint.md) does not support the md5 and sha1 method.
74-
* The [Community ID Network Flowhash processor](beats://reference/metricbeat/community-id.md) is not supported.
75-
* The [Azure module](beats://reference/metricbeat/metricbeat-module-azure.md) is currently not supported. The [Add Cloud Metadata processor](beats://reference/metricbeat/add-cloud-metadata.md) does not support the Azure Virtual Machine provider currently.
76-
* The [Google Cloud Platform module](https://www.elastic.co/docs/reference/beats/metricbeat/metricbeat-module-gcp) is currently not supported.
73+
* The [Fingerprint processor](beats://reference/metricbeat/fingerprint.md) does not support the md5 and sha1 method.
74+
* The [Community ID Network Flowhash processor](beats://reference/metricbeat/community-id.md) is not supported.
75+
* The [Azure module](beats://reference/metricbeat/metricbeat-module-azure.md) is currently not supported. The [Add Cloud Metadata processor](beats://reference/metricbeat/add-cloud-metadata.md) does not support the Azure Virtual Machine provider currently.
76+
* The [Google Cloud Platform module](https://www.elastic.co/docs/reference/beats/metricbeat/metricbeat-module-gcp) is currently not supported.
7777
* The [Beta KVM module](beats://reference/metricbeat/metricbeat-module-kvm.md) is not yet supported.
78-
* The [Mongo DB module](beats://reference/metricbeat/metricbeat-module-mongodb.md) is not supported.
79-
* The [MySQL](beats://reference/metricbeat/metricbeat-module-mysql.md), [PostgreSQL](beats://reference/metricbeat/metricbeat-module-postgresql.md), [MSSQL](beats://reference/metricbeat/metricbeat-module-mssql.md) and [SQL](beats://reference/metricbeat/metricbeat-module-sql.md) modules are not supported.
80-
* The [Oracle module](beats://reference/metricbeat/metricbeat-module-oracle.md) is not supported.
78+
* The [Mongo DB module](beats://reference/metricbeat/metricbeat-module-mongodb.md) is not supported.
79+
* The [MySQL](beats://reference/metricbeat/metricbeat-module-mysql.md), [PostgreSQL](beats://reference/metricbeat/metricbeat-module-postgresql.md), [MSSQL](beats://reference/metricbeat/metricbeat-module-mssql.md) and [SQL](beats://reference/metricbeat/metricbeat-module-sql.md) modules are not supported.
80+
* The [Oracle module](beats://reference/metricbeat/metricbeat-module-oracle.md) is not supported.
8181

8282
### Elastic Agent and Fleet Server [ingest-limitations-agent]
8383

@@ -87,7 +87,7 @@ When you use {{agent}} and {{fleet-server}}, these limitations apply:
8787

8888
### Elastic Integrations that are not FIPS compatible [ingest-limitations-integrations]
8989

90-
These Elastic Integrations have components that are **not** FIPS compatible, and **cannot** be used in FIPS environments, even if combined with other ingest tools that offer FIPS mode.
90+
These Elastic Integrations have components that are **not** FIPS compatible, and **cannot** be used in FIPS environments, even if combined with other ingest tools that offer FIPS mode.
9191

9292
- [Azure Logs Integration (v2 preview)](integration-docs://reference/azure/events.md)
9393
- [Azure Event Hub Input](integration-docs://reference/azure/eventhub.md)
@@ -99,7 +99,7 @@ These Elastic Integrations have components that are **not** FIPS compatible, and
9999
- [Custom Azure Logs Integration](integration-docs://reference/azure_logs.md)
100100
- [Azure Resource Metrics Integration](integration-docs://reference/azure_metrics.md)
101101
- [Azure OpenAI Integration](integration-docs://reference/azure_openai.md)
102-
- [SQL Input](integration-docs://reference/sql.md)
102+
- [SQL Input](integration-docs://reference/sql.md)
103103
- [PostgreSQL Integration](integration-docs://reference/postgresql.md)
104104
- [MongoDB Integration](integration-docs://reference/mongodb.md)
105105
- [MySQL Integration](integration-docs://reference/mysql.md)

0 commit comments

Comments
 (0)