Skip to content

Commit ad1782b

Browse files
authored
Merge branch 'main' into 20250417-transform-link
2 parents ac6e0cb + cd7b3e9 commit ad1782b

File tree

11 files changed

+242
-16
lines changed

11 files changed

+242
-16
lines changed
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
name: "Label new issues with needs-team"
2+
3+
on:
4+
issues:
5+
types: [opened]
6+
7+
jobs:
8+
add-needs-triage-label:
9+
name: Add `needs-team` label
10+
runs-on: ubuntu-latest
11+
steps:
12+
- name: Add the needs-team label
13+
uses: actions-ecosystem/action-add-labels@v1
14+
with:
15+
labels: |
16+
needs-team
17+
env:
18+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/add-to-board.yml

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
name: Triage & route issues
2+
3+
on:
4+
issues:
5+
types: [labeled]
6+
7+
permissions:
8+
issues: write
9+
contents: read
10+
11+
jobs:
12+
route:
13+
runs-on: ubuntu-latest
14+
if: |
15+
github.event.label.name == 'team:DocsEng' ||
16+
github.event.label.name == 'team:Obs' ||
17+
github.event.label.name == 'team:Platform' ||
18+
github.event.label.name == 'team:Projects' ||
19+
github.event.label.name == 'team:Search' ||
20+
github.event.label.name == 'team:Security'
21+
env:
22+
PROJECT_ID_MAP: |
23+
{
24+
"team:DocsEng": "1625",
25+
"team:Obs": "649",
26+
"team:Platform": "1232",
27+
"team:Projects": "1415",
28+
"team:Search": "726",
29+
"team:Security": "1034"
30+
}
31+
steps:
32+
- name: Remove needs-team label
33+
uses: actions-ecosystem/action-remove-labels@v1
34+
with:
35+
labels: needs-team
36+
37+
- name: Add issue to the right project
38+
uses: actions/add-to-project@244f685bbc3b7adfa8466e08b698b5577571133e
39+
with:
40+
project-url: https://github.com/orgs/elastic/projects/${{ fromJson(env.PROJECT_ID_MAP)[github.event.label.name] }}
41+
github-token: ${{ secrets.ADD_TO_BOARD_TOKEN }}
42+
labeled: ${{ github.event.label.name }}
43+
label-operator: OR

deploy-manage/autoscaling/autoscaling-in-eck.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,14 @@ Configure autoscaling for {{es}} deployments in {{eck}}. Learn how to enable aut
2020

2121
ECK can leverage the [autoscaling API](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-autoscaling) introduced in {{es}} 7.11 to adjust automatically the number of Pods and the allocated resources in a tier. Currently, autoscaling is supported for {{es}} [data tiers](/manage-data/lifecycle/data-tiers.md) and machine learning nodes.
2222

23+
### Supported Resources for Autoscaling per Elasticsearch Tier
24+
25+
| Tiers | Storage | Memory | CPU |
26+
| --- | ---| --- | --- |
27+
| Data Nodes (except Frozen) | Yes | Calculated proportionally to the required amount of storage | Calculated proportionally to the required amount of memory
28+
| Frozen Nodes | Yes | Yes | Calculated proportionally to the required amount of memory
29+
| Machine Learning | No | Yes | Calculated proportionally to the required amount of memory
30+
2331

2432
### Enable autoscaling [k8s-enable]
2533

@@ -345,4 +353,4 @@ spec:
345353
target:
346354
type: Utilization
347355
averageUtilization: 50
348-
```
356+
```

deploy-manage/deploy/cloud-enterprise/default-system-deployment-versions.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,10 @@ Note that since version 2.7.0, system deployments are automatically upgraded whe
1414

1515
| {{ece}} version | Admin cluster | Logging & Metrics cluster | Security cluster |
1616
| --- | --- | --- | --- |
17+
| 4.0.0 | 8.18.0 | 8.18.0 | 8.18.0 |
18+
| 3.8.0 | 8.17.4 | 8.17.4 | 8.17.4 |
19+
| 3.7.3 | 7.17.24 | 7.17.24 | 8.15.2 |
20+
| 3.7.2 | 7.17.22 | 7.17.22 | 8.13.4 |
1721
| 3.7.1 | 7.17.20 | 7.17.20 | 8.13.2 |
1822
| 3.6.2 | 7.17.15 | 7.17.15 | 8.11.1 |
1923
| 3.6.1 | 7.17.13 | 7.17.13 | 8.9.2 |

manage-data/data-store/data-streams/logs-data-stream.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,7 +143,7 @@ By default, `logsdb` index mode sets `ignore_malformed` to `true`. With this set
143143

144144
### `ignore_above` [logs-db-ignore-above]
145145

146-
In `logsdb` index mode, the `index.mapping.ignore_above` setting is applied by default at the index level to ensure efficient storage and indexing of large keyword fields.The index-level default for `ignore_above` is 8191 *characters.* Using UTF-8 encoding, this results in a limit of 32764 bytes, depending on character encoding.
146+
In `logsdb` index mode, the `index.mapping.ignore_above` setting is applied by default at the index level to ensure efficient storage and indexing of large keyword fields. This applies to all members of the keyword type family (keyword, constant_keyword, and wildcard). The index-level default for `ignore_above` is 8191 *characters.* Using UTF-8 encoding, this results in a limit of 32764 bytes, depending on character encoding.
147147

148148
The mapping-level `ignore_above` setting takes precedence. If a specific field has an `ignore_above` value defined in its mapping, that value overrides the index-level `index.mapping.ignore_above` value. This default behavior helps to optimize indexing performance by preventing excessively large string values from being indexed.
149149

reference/fleet/fleet-api-docs.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -405,3 +405,51 @@ Example response (formatted for readability):
405405
"total" : 4
406406
}
407407
```
408+
409+
## List all {{agents}} [list-agents-api]
410+
411+
Use the [Get agents API](https://www.elastic.co/docs/api/doc/kibana/operation/operation-get-fleet-agents) to retrieve a list of currently enrolled {{agents}}:
412+
413+
```shell
414+
curl -X GET 'http://<user>:<pass>@<kibana url>/api/fleet/agents
415+
```
416+
417+
By default, a maximum of 10,000 agents are returned, with 20 agents listed per page.
418+
419+
### List all {{agents}} with `perPage` setting [list-agents-api-perpage]
420+
421+
The following query returns the same list, showing 10,000 {{agents}} per page:
422+
423+
```shell
424+
curl -X GET 'http://<user>:<pass>@<kibana url>/api/fleet/agents?perPage=10000'
425+
```
426+
427+
### List the next set of 10,000 {{agents}} [list-agents-api-next-set]
428+
```{applies_to}
429+
stack: ga 9.1
430+
```
431+
432+
Beginning with {{stack}} version 9.1, the previous query response includes a `nextSearchAfter` parameter that you can pass in a subsequent call, to retrieve the next page of 10,000 enrolled agents:
433+
434+
```shell
435+
curl -X GET 'http://<user>:<pass>@<kibana url>/api/fleet/agents?perPage=10000&searchAfter=<nextSearchAfter>'
436+
```
437+
438+
### List all {{agents}} for a point in time [list-agents-api-point-in-time]
439+
```{applies_to}
440+
stack: ga 9.1
441+
```
442+
443+
Beginning with {{stack}} version 9.1, you can also capture a point-in-time ID (`pitId`) parameter from the `Get agents API` response, and use that together with the `nextSearchAfter` parameter to capture the next page of 10,000 enrolled agents for a specific point in time.
444+
445+
Include the `openPit` and `pitKeepAlive` parameters in your initial request:
446+
447+
```shell
448+
curl -X GET 'http://<user>:<pass>@<kibana url>/api/fleet/agents?perPage=10000&openPit=true&pitKeepAlive=5m'
449+
```
450+
451+
You can then use the returned values in a new request to retrieve the next set of 10,000 agents:
452+
453+
```shell
454+
curl -X GET 'http://<user>:<pass>@<kibana url>/api/fleet/agents?perPage=10000&searchAfter=<nextSearchAfter>&pitId=<pit id>&pitKeepAlive=5m'
455+
```

reference/fleet/ls-output-settings.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ input {
2424
elastic_agent {
2525
port => 5044
2626
enrich => none <1>
27-
ssl => true
27+
ssl_enabled => true
2828
ssl_certificate_authorities => ["<ca_path>"]
2929
ssl_certificate => "<server_cert_path>"
3030
ssl_key => "<server_cert_key_in_pkcs8>"
@@ -38,7 +38,7 @@ output {
3838
data_stream => "true"
3939
api_key => "<api_key>" <3>
4040
data_stream => true
41-
ssl => true
41+
ssl_enabled => true
4242
# cacert => "<elasticsearch_ca_path>"
4343
}
4444
}

solutions/observability/apm/get-started-apm-server-binary.md

Lines changed: 104 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -761,11 +761,83 @@ to sign all our packages. It is available from [https://pgp.mit.edu](https://pgp
761761
762762
### APT [_apt]
763763
764-
Version 9.0.0-beta1 of apm-server has not yet been released.
764+
To add the apm-server repository for APT:
765+
766+
1. Download and install the Public Signing Key:
767+
768+
```shell
769+
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
770+
```
771+
772+
1. You may need to install the `apt-transport-https` package on Debian before proceeding:
773+
774+
```shell
775+
sudo apt-get install apt-transport-https
776+
```
777+
778+
1. Save the repository definition to `/etc/apt/sources.list.d/elastic-9.0.0.list`:
779+
780+
```shell
781+
echo "deb https://artifacts.elastic.co/packages/9.0.0-prerelease/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-9.0.0-prerelease.list
782+
```
783+
784+
:::{warning}
785+
To add the Elastic repository, make sure that you use the `echo` method shown in the example. Do not use `add-apt-repository` because it will add a `deb-src` entry, but we do not provide a source package.
786+
787+
If you have added the `deb-src` entry by mistake, you will see an error like the following:
788+
789+
```text
790+
Unable to find expected entry 'main/source/Sources' in Release file (Wrong sources.list entry or malformed file)
791+
```
792+
:::
793+
794+
1. Run `apt-get update`, and the repository is ready for use. For example, you can install APM Server by running:
795+
796+
```shell
797+
sudo apt-get update && sudo apt-get install apm-server
798+
```
799+
800+
1. To configure APM Server to start automatically during boot, run:
801+
802+
```shell
803+
sudo systemctl enable apm-server
804+
```
765805
766806
### YUM [_yum]
767807
768-
Version 9.0.0-beta1 of apm-server has not yet been released.
808+
To add the apm-server repository for YUM:
809+
810+
1. Download and install the public signing key:
811+
812+
```shell
813+
sudo rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch
814+
```
815+
816+
1. Create a file with a .repo extension (for example, elastic.repo) in your /etc/yum.repos.d/ directory and add the following lines:
817+
818+
```shell
819+
[elastic-9.0.0]
820+
name=Elastic repository for 9.0.0 packages
821+
baseurl=https://artifacts.elastic.co/packages/9.0.0/yum
822+
gpgcheck=1
823+
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
824+
enabled=1
825+
autorefresh=1
826+
type=rpm-md
827+
```
828+
829+
Your repository is ready to use. For example, you can install APM Server by running:
830+
831+
```shell
832+
sudo yum install apm-server
833+
```
834+
835+
1. To configure APM Server to start automatically during boot, run:
836+
837+
```shell
838+
sudo systemctl enable apm-server
839+
```
840+
769841
770842
## Run APM Server on Docker [apm-running-on-docker]
771843
@@ -779,7 +851,34 @@ These images are free to use under the Elastic license. They contain open source
779851
780852
Obtaining APM Server for Docker is as simple as issuing a `docker pull` command against the Elastic Docker registry and then, optionally, verifying the image.
781853
782-
However, version 9.0.0-beta1 of APM Server has not yet been released, so no Docker image is currently available for this version.
854+
1. Pull the Docker image:
855+
856+
```shell
857+
docker pull docker.elastic.co/apm/apm-server:9.0.0
858+
```
859+
860+
Alternately, you can use the hardened [Wolfi](https://wolfi.dev/) image:
861+
862+
```shell
863+
docker pull docker.elastic.co/apm/apm-server-wolfi:9.0.0
864+
```
865+
866+
1. Verify the Docker image:
867+
868+
```shell
869+
wget https://artifacts.elastic.co/cosign.pub
870+
cosign verify --key cosign.pub docker.elastic.co/apm/apm-server:9.0.0
871+
```
872+
873+
The `cosign` command prints the check results and the signature payload in JSON format:
874+
875+
```shell
876+
Verification for docker.elastic.co/apm/apm-server:9.0.0 --
877+
The following checks were performed on each of these signatures:
878+
- The cosign claims were validated
879+
- Existence of the claims in the transparency log was verified offline
880+
- The signatures were verified against the specified public key
881+
```
783882
784883
### Configure APM Server on Docker [_configure_apm_server_on_docker]
785884
@@ -803,7 +902,7 @@ docker run -d \
803902
--name=apm-server \
804903
--user=apm-server \
805904
--volume="$(pwd)/apm-server.docker.yml:/usr/share/apm-server/apm-server.yml:ro" \
806-
docker.elastic.co/apm/apm-server:9.0.0-beta1 \
905+
docker.elastic.co/apm/apm-server:9.0.0 \
807906
--strict.perms=false -e \
808907
-E output.elasticsearch.hosts=["elasticsearch:9200"] <1> <2>
809908
```
@@ -820,6 +919,6 @@ The `apm-server.docker.yml` downloaded earlier should be customized for your env
820919
It’s possible to embed your APM Server configuration in a custom image. Here is an example Dockerfile to achieve this:
821920
822921
```dockerfile
823-
FROM docker.elastic.co/apm/apm-server:9.0.0-beta1
922+
FROM docker.elastic.co/apm/apm-server:9.0.0
824923
COPY --chmod=0644 --chown=1000:1000 apm-server.yml /usr/share/apm-server/apm-server.yml
825924
```

solutions/search/cross-cluster-search.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ mapped_pages:
33
- https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-cross-cluster-search.html
44
applies_to:
55
stack:
6-
serverless:
6+
serverless: unavailable
77
---
88

99
# Cross-cluster search [modules-cross-cluster-search]

solutions/search/ranking/semantic-reranking.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@ To use semantic re-ranking in {{es}}, you need to:
8888

8989
1. **Select and configure a re-ranking model**. You have the following options:
9090

91-
1. Use the Elastic Rerank cross-encoder model via the [inference API's {{es}} service](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put-elasticsearch).
91+
1. Use the Elastic Rerank cross-encoder model through a preconfigured `.rerank-v1-elasticsearch` endpoint or create a custom one using the [inference API's {{es}} service](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put-elasticsearch).
9292
2. Use the [Cohere Rerank inference endpoint](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put-cohere) to create a `rerank` endpoint.
9393
3. Use the [Google Vertex AI inference endpoint](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put-googlevertexai) to create a `rerank` endpoint.
9494
4. Upload a model to {{es}} from Hugging Face with [Eland](eland://reference/machine-learning.md#ml-nlp-pytorch). You’ll need to use the `text_similarity` NLP task type when loading the model using Eland. Then set up an [{{es}} service inference endpoint](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put-elasticsearch) with the `rerank` endpoint type.

0 commit comments

Comments
 (0)