Skip to content

Commit

Permalink
Merge branch '8.x' into markjhoy/add_enterprise_search_deprecation_ca…
Browse files Browse the repository at this point in the history
…llouts
  • Loading branch information
markjhoy authored Oct 10, 2024
2 parents ac35439 + 1719921 commit e7ac770
Show file tree
Hide file tree
Showing 715 changed files with 15,770 additions and 21,225 deletions.
1 change: 1 addition & 0 deletions .eslintrc.js
Original file line number Diff line number Diff line change
Expand Up @@ -978,6 +978,7 @@ module.exports = {
files: [
'x-pack/plugins/observability_solution/**/!(*.stories.tsx|*.test.tsx|*.storybook_decorator.tsx|*.mock.tsx)',
'src/plugins/ai_assistant_management/**/!(*.stories.tsx|*.test.tsx|*.storybook_decorator.tsx|*.mock.tsx)',
'x-pack/packages/observability/logs_overview/**/!(*.stories.tsx|*.test.tsx|*.storybook_decorator.tsx|*.mock.tsx)',
],
rules: {
'@kbn/i18n/strings_should_be_translated_with_i18n': 'warn',
Expand Down
1 change: 1 addition & 0 deletions .github/workflows/oblt-github-commands.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ on:

permissions:
contents: read
issues: write
pull-requests: write

jobs:
Expand Down
31 changes: 0 additions & 31 deletions NOTICE.txt
Original file line number Diff line number Diff line change
Expand Up @@ -74,37 +74,6 @@ under a "BSD" license.

Distributed under the BSD license:

Copyright (c) 2010, Ajax.org B.V.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of Ajax.org B.V. nor the
names of its contributors may be used to endorse or promote products
derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL AJAX.ORG B.V. BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

---
This product includes code that is based on Ace editor, which was available
under a "BSD" license.

Distributed under the BSD license:

Copyright (c) 2010, Ajax.org B.V.
All rights reserved.

Expand Down
4 changes: 2 additions & 2 deletions api_docs/kbn_elastic_assistant_common.devdocs.json
Original file line number Diff line number Diff line change
Expand Up @@ -3413,7 +3413,7 @@
"label": "ReadKnowledgeBaseResponse",
"description": [],
"signature": [
"{ elser_exists?: boolean | undefined; esql_exists?: boolean | undefined; index_exists?: boolean | undefined; is_setup_available?: boolean | undefined; is_setup_in_progress?: boolean | undefined; pipeline_exists?: boolean | undefined; }"
"{ elser_exists?: boolean | undefined; index_exists?: boolean | undefined; is_setup_available?: boolean | undefined; is_setup_in_progress?: boolean | undefined; pipeline_exists?: boolean | undefined; }"
],
"path": "x-pack/packages/kbn-elastic-assistant-common/impl/schemas/knowledge_base/crud_kb_route.gen.ts",
"deprecated": false,
Expand Down Expand Up @@ -5692,7 +5692,7 @@
"label": "ReadKnowledgeBaseResponse",
"description": [],
"signature": [
"Zod.ZodObject<{ elser_exists: Zod.ZodOptional<Zod.ZodBoolean>; esql_exists: Zod.ZodOptional<Zod.ZodBoolean>; index_exists: Zod.ZodOptional<Zod.ZodBoolean>; is_setup_available: Zod.ZodOptional<Zod.ZodBoolean>; is_setup_in_progress: Zod.ZodOptional<Zod.ZodBoolean>; pipeline_exists: Zod.ZodOptional<Zod.ZodBoolean>; }, \"strip\", Zod.ZodTypeAny, { elser_exists?: boolean | undefined; esql_exists?: boolean | undefined; index_exists?: boolean | undefined; is_setup_available?: boolean | undefined; is_setup_in_progress?: boolean | undefined; pipeline_exists?: boolean | undefined; }, { elser_exists?: boolean | undefined; esql_exists?: boolean | undefined; index_exists?: boolean | undefined; is_setup_available?: boolean | undefined; is_setup_in_progress?: boolean | undefined; pipeline_exists?: boolean | undefined; }>"
"Zod.ZodObject<{ elser_exists: Zod.ZodOptional<Zod.ZodBoolean>; index_exists: Zod.ZodOptional<Zod.ZodBoolean>; is_setup_available: Zod.ZodOptional<Zod.ZodBoolean>; is_setup_in_progress: Zod.ZodOptional<Zod.ZodBoolean>; pipeline_exists: Zod.ZodOptional<Zod.ZodBoolean>; }, \"strip\", Zod.ZodTypeAny, { elser_exists?: boolean | undefined; esql_exists?: boolean | undefined; index_exists?: boolean | undefined; is_setup_available?: boolean | undefined; is_setup_in_progress?: boolean | undefined; pipeline_exists?: boolean | undefined; }, { elser_exists?: boolean | undefined; esql_exists?: boolean | undefined; index_exists?: boolean | undefined; is_setup_available?: boolean | undefined; is_setup_in_progress?: boolean | undefined; pipeline_exists?: boolean | undefined; }>"
],
"path": "x-pack/packages/kbn-elastic-assistant-common/impl/schemas/knowledge_base/crud_kb_route.gen.ts",
"deprecated": false,
Expand Down
4 changes: 4 additions & 0 deletions dev_docs/nav-kibana-dev.docnav.json
Original file line number Diff line number Diff line change
Expand Up @@ -278,6 +278,10 @@
{
"id": "kibDevReactKibanaContext",
"label": "Kibana React Contexts"
},
{
"id": "kibDevDocsChromeRecentlyAccessed",
"label": "Recently Viewed"
}
]
},
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
id: kibDevDocsChromeRecentlyAccessed
slug: /kibana-dev-docs/chrome/recently-accessed
title: Chrome Recently Viewed
description: How to use chrome's recently accessed service to add your links to the recently viewed list in the side navigation.
date: 2024-10-04
tags: ['kibana', 'dev', 'contributor', 'chrome', 'navigation', 'shared-ux']
---

## Introduction

The <DocLink id="kibKbnCoreChromeBrowserPluginApi" section="def-public.ChromeRecentlyAccessed" text="ChromeRecentlyAccessed" /> service allows applications to register recently visited objects. These items are displayed in the "Recently Viewed" section of a side navigation menu, providing users with quick access to their previously visited resources. This service includes methods for adding, retrieving, and subscribing to the recently accessed history.

![Recently viewed section in the sidenav](./chrome_recently_accessed.png)

## Guidelines

The <DocLink id="kibKbnCoreChromeBrowserPluginApi" section="def-public.ChromeRecentlyAccessed" text="ChromeRecentlyAccessed" /> service should be used thoughtfully to provide users with easy access to key resources they've interacted with. Unlike browser history, this feature is for important items that users may want to revisit.

### DOs

- Register important resources that users may want to revisit. Like a dashboard, a saved search, or another specific object.
- Update the link when the state of the current resource changes. For example, if a user changes the time range while on a dashboard, update the recently viewed link to reflect the latest viewed state where possible. See below for instructions on how to update the link when state changes.

### DON'Ts

- Don't register every page view.
- Don't register temporary or transient states as individual items.
- Prevent overloading. Keep the list focused on high-value resources.
- Don't add a recently viewed object without first speaking to relevant Product Managers.

## Usage

To register an item with the `ChromeRecentlyAccessed` service, provide a unique `id`, a `label`, and a `link`. The `id` is used to identify and deduplicate the item, the `label` is displayed in the "Recently Viewed" list and the `link` is used to navigate to the item when selected.

```ts
const link = '/app/map/1234';
const label = 'Map 1234';
const id = 'map-1234';

coreStart.chrome.recentlyAccessed.add(link, label, id);
```

To update the link when state changes, add another item with the same `id`. This will replace the existing item in the "Recently Viewed" list.

```ts
const link = '/app/map/1234';
const label = 'Map 1234';

coreStart.chrome.recentlyAccessed.add(`/app/map/1234`, label, id);

// User changes the time range and we want to update the link in the "Recently Viewed" list
coreStart.chrome.recentlyAccessed.add(
`/app/map/1234?timeRangeFrom=now-30m&timeRangeTo=now`,
label,
id
);
```

## Implementation details

The <DocLink id="kibKbnCoreChromeBrowserPluginApi" section="def-public.ChromeRecentlyAccessed" text="ChromeRecentlyAccessed" /> services is based on <DocLink id="kibKbnRecentlyAccessedPluginApi" text="@kbn/recently-accessed"/> package. This package provides a `RecentlyAccessedService` that uses browser local storage to manage records of recently accessed objects. Internally it implements the queue with a maximum length of 20 items. When the queue is full, the oldest item is removed.
Applications can create their own instance of `RecentlyAccessedService` to manage their own list of recently accessed items scoped to their application.

- <DocLink id="kibKbnCoreChromeBrowserPluginApi" section="def-public.ChromeRecentlyAccessed" text="ChromeRecentlyAccessed" /> is a service available via `coreStart.chrome.recentlyAccessed` and should be used to add items to chrome's sidenav.
- <DocLink id="kibKbnRecentlyAccessedPluginApi" text="@kbn/recently-accessed"/> is package that `ChromeRecentlyAccessed` is using internally and the package can be used to create your own instance and manage your own list of recently accessed items that is independent for chrome's sidenav.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 5 additions & 0 deletions dev_docs/shared_ux/shared_ux_landing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -66,5 +66,10 @@ layout: landing
title: 'Kibana React Contexts',
description: 'Learn how to use common React contexts in Kibana',
},
{
pageId: 'kibDevDocsChromeRecentlyAccessed',
title: 'Chrome Recently Viewed',
description: 'Learn how to add recently viewed items to the side navigation',
},
]}
/>
78 changes: 39 additions & 39 deletions docs/search/index.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ The *Search* space in {kib} comprises the following features:
* <<playground,Playground>>
* https://www.elastic.co/guide/en/elasticsearch/reference/current/search-application-overview.html[Search Applications]
* https://www.elastic.co/guide/en/elasticsearch/reference/current/behavioral-analytics-overview.html[Behavioral Analytics]
* Inference Endpoints UI
* AI Assistant for Search
* <<inference-endpoints,Inference Endpoints UI>>
* <<search-assistant,AI Assistant for Search>>
* Persistent Dev Tools <<console-kibana, Console>>

[float]
Expand All @@ -19,53 +19,53 @@ The *Search* space in {kib} comprises the following features:

The Search solution and use case is made up of many tools and features across the {stack}.
As a result, the release notes for your features of interest might live in different Elastic docs.
// Use the following table to find links to the appropriate documentation, API references (if applicable), and release notes.
Use the following table to find links to the appropriate documentation, API references (if applicable), and release notes.

// [options="header"]
// |===
// | Name | API reference | Documentation | Release notes
[options="header"]
|===
| Name | API reference | Documentation | Release notes

// | Connectors
// | link:https://example.com/connectors/api[API reference]
// | link:https://example.com/connectors/docs[Documentation]
// | link:https://example.com/connectors/notes[Release notes]
| Connectors
| {ref}/connector-apis.html[API reference]
| {ref}/es-connectors.html[Elastic Connectors]
| {ref}/es-connectors-release-notes.html[Elasticsearch guide]

// | Web crawler
// | link:https://example.com/web_crawlers/api[API reference]
// | link:https://example.com/web_crawlers/docs[Documentation]
// | link:https://example.com/web_crawlers/notes[Release notes]
| Web crawler
| N/A
| {enterprise-search-ref}/crawler.html[Documentation]
| {enterprise-search-ref}/changelog.html[Enterprise Search Guide]

// | Playground
// | link:https://example.com/playground/api[API reference]
// | link:https://example.com/playground/docs[Documentation]
// | link:https://example.com/playground/notes[Release notes]
| Playground
| N/A
| {kibana-ref}/playground.html[Documentation]
| {kibana-ref}/release-notes.html[Kibana guide]

// | Search Applications
// | link:https://example.com/search_apps/api[API reference]
// | link:https://example.com/search_apps/docs[Documentation]
// | link:https://example.com/search_apps/notes[Release notes]
| Search Applications
| {ref}/search-application-apis.html[API reference]
| {enterprise-search-ref}/app-search-workplace-search.html[Documentation]
| {ref}/es-release-notes.html[Elasticsearch guide]

// | Behavioral Analytics
// | link:https://example.com/behavioral_analytics/api[API reference]
// | link:https://example.com/behavioral_analytics/docs[Documentation]
// | link:https://example.com/behavioral_analytics/notes[Release notes]
| Behavioral Analytics
| {ref}/behavioral-analytics-apis.html[API reference]
| {ref}/behavioral-analytics-start.html[Documentation]
| {ref}/es-release-notes.html[Elasticsearch guide]

// | Inference Endpoints
// | link:https://example.com/inference_endpoints/api[API reference]
// | link:https://example.com/inference_endpoints/docs[Documentation]
// | link:https://example.com/inference_endpoints/notes[Release notes]
| Inference Endpoints
| {ref}/inference-apis.html[API reference]
| {kibana-ref}/inference-endpoints.html[Documentation]
| {ref}/es-release-notes.html[Elasticsearch guide]

// | Console
// | link:https://example.com/console/api[API reference]
// | link:https://example.com/console/docs[Documentation]
// | link:https://example.com/console/notes[Release notes]
| Console
| N/A
| {kibana-ref}/console-kibana.html[Documentation]
| {kibana-ref}/release-notes.html[Kibana guide]

// | Search UI
// | link:https://www.elastic.co/docs/current/search-ui/api/architecture[API reference]
// | link:https://www.elastic.co/docs/current/search-ui/overview[Documentation]
// | link:https://example.com/search_ui/notes[Release notes]
| Search UI
| https://www.elastic.co/docs/current/search-ui/api/architecture[API reference]
| https://www.elastic.co/docs/current/search-ui[Documentation]
| https://www.elastic.co/docs/current/search-ui[Search UI]

// |===
|===

include::search-connection-details.asciidoc[]
include::playground/index.asciidoc[]
Expand Down
56 changes: 56 additions & 0 deletions oas_docs/output/kibana.serverless.staging.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -21405,6 +21405,31 @@ components:
title: Package information
type: object
properties:
agent:
type: object
properties:
privileges:
type: object
properties:
root:
type: boolean
asset_tags:
items:
type: object
properties:
asset_ids:
items:
type: string
type: array
asset_types:
items:
type: string
type: array
text:
type: string
required:
- text
type: array
assets:
items:
type: string
Expand Down Expand Up @@ -21469,6 +21494,18 @@ components:
type: array
description:
type: string
discovery:
type: object
properties:
fields:
items:
type: object
properties:
name:
type: string
required:
- name
type: array
download:
type: string
elasticsearch:
Expand All @@ -21491,6 +21528,19 @@ components:
type: boolean
name:
type: string
owner:
type: object
properties:
github:
type: string
type:
enum:
- elastic
- partner
- community
type: string
required:
- github
path:
type: string
readme:
Expand Down Expand Up @@ -21534,6 +21584,10 @@ components:
title:
type: string
type:
enum:
- integration
- input
- content
type: string
version:
type: string
Expand All @@ -21549,6 +21603,7 @@ components:
- format_version
- download
- path
- owner
Fleet_package_policy:
allOf:
- type: object
Expand Down Expand Up @@ -22906,6 +22961,7 @@ components:
enum:
- OpenAI
- Azure OpenAI
- Other
type: string
Security_AI_Assistant_API_Reader:
additionalProperties: true
Expand Down
Loading

0 comments on commit e7ac770

Please sign in to comment.