-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' into convert-typescript
- Loading branch information
Showing
43 changed files
with
1,235 additions
and
223 deletions.
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
77 changes: 77 additions & 0 deletions
77
src/plugins/home/server/tutorials/googlecloud_metrics/index.ts
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,77 @@ | ||
/* | ||
* Licensed to Elasticsearch B.V. under one or more contributor | ||
* license agreements. See the NOTICE file distributed with | ||
* this work for additional information regarding copyright | ||
* ownership. Elasticsearch B.V. licenses this file to you under | ||
* the Apache License, Version 2.0 (the "License"); you may | ||
* not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, | ||
* software distributed under the License is distributed on an | ||
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | ||
* KIND, either express or implied. See the License for the | ||
* specific language governing permissions and limitations | ||
* under the License. | ||
*/ | ||
|
||
import { i18n } from '@kbn/i18n'; | ||
import { TutorialsCategory } from '../../services/tutorials'; | ||
import { | ||
onPremInstructions, | ||
cloudInstructions, | ||
onPremCloudInstructions, | ||
} from '../instructions/metricbeat_instructions'; | ||
import { | ||
TutorialContext, | ||
TutorialSchema, | ||
} from '../../services/tutorials/lib/tutorials_registry_types'; | ||
|
||
export function googlecloudMetricsSpecProvider(context: TutorialContext): TutorialSchema { | ||
const moduleName = 'googlecloud'; | ||
return { | ||
id: 'googlecloudMetrics', | ||
name: i18n.translate('home.tutorials.googlecloudMetrics.nameTitle', { | ||
defaultMessage: 'Google Cloud metrics', | ||
}), | ||
category: TutorialsCategory.METRICS, | ||
shortDescription: i18n.translate('home.tutorials.googlecloudMetrics.shortDescription', { | ||
defaultMessage: | ||
'Fetch monitoring metrics from Google Cloud Platform using Stackdriver Monitoring API.', | ||
}), | ||
longDescription: i18n.translate('home.tutorials.googlecloudMetrics.longDescription', { | ||
defaultMessage: | ||
'The `googlecloud` Metricbeat module fetches monitoring metrics from Google Cloud Platform using Stackdriver Monitoring API. \ | ||
[Learn more]({learnMoreLink}).', | ||
values: { | ||
learnMoreLink: '{config.docs.beats.metricbeat}/metricbeat-module-googlecloud.html', | ||
}, | ||
}), | ||
euiIconType: 'logoGCP', | ||
isBeta: false, | ||
artifacts: { | ||
dashboards: [ | ||
{ | ||
id: 'f40ee870-5e4a-11ea-a4f6-717338406083', | ||
linkLabel: i18n.translate( | ||
'home.tutorials.googlecloudMetrics.artifacts.dashboards.linkLabel', | ||
{ | ||
defaultMessage: 'Google Cloud metrics dashboard', | ||
} | ||
), | ||
isOverview: true, | ||
}, | ||
], | ||
exportedFields: { | ||
documentationUrl: '{config.docs.beats.metricbeat}/exported-fields-googlecloud.html', | ||
}, | ||
}, | ||
completionTimeMinutes: 10, | ||
previewImagePath: '/plugins/home/assets/googlecloud_metrics/screenshot.png', | ||
onPrem: onPremInstructions(moduleName, context), | ||
elasticCloud: cloudInstructions(moduleName), | ||
onPremElasticCloud: onPremCloudInstructions(moduleName), | ||
}; | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
37 changes: 37 additions & 0 deletions
37
src/plugins/kibana_usage_collection/server/collectors/application_usage/README.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,37 @@ | ||
# Application Usage | ||
|
||
This collector reports the number of general clicks and minutes on screen for each registered application in Kibana. | ||
|
||
The final payload matches the following contract: | ||
|
||
```JSON | ||
{ | ||
"application_usage": { | ||
"application_ID": { | ||
"clicks_7_days": 10, | ||
"clicks_30_days": 100, | ||
"clicks_90_days": 300, | ||
"clicks_total": 600, | ||
"minutes_on_screen_7_days": 10.40, | ||
"minutes_on_screen_30_days": 20.0, | ||
"minutes_on_screen_90_days": 110.1, | ||
"minutes_on_screen_total": 112.5 | ||
} | ||
} | ||
} | ||
``` | ||
|
||
Where `application_ID` matches the `id` registered when calling the method `core.application.register`. | ||
This collection occurs by default for every application registered via the mentioned method and there is no need to do anything else to enable it or _opt-in_ for your plugin. | ||
|
||
**Note to maintainers in the Kibana repo:** At the moment of writing, the `usageCollector.schema` is not updated automatically ([#70622](https://github.com/elastic/kibana/issues/70622)) so, if you are adding a new app to Kibana, you'll need to give the Kibana Telemetry team a heads up to update the mappings in the Telemetry Cluster accordingly. | ||
|
||
## Developer notes | ||
|
||
In order to keep the count of the events, this collector uses 2 Saved Objects: | ||
|
||
1. `application_usage_transactional`: It stores each individually reported event (up to 90 days old). Grouped by `timestamp` and `appId`. | ||
2. `application_usage_totals`: It stores the sum of all the events older than 90 days old per `appId`. | ||
|
||
Both of them use the shared fields `appId: 'keyword'`, `numberOfClicks: 'long'` and `minutesOnScreen: 'float'`. `application_usage_transactional` also stores `timestamp: { type: 'date' }`. | ||
but they are currently not added in the mappings because we don't use them for search purposes, and we need to be thoughtful with the number of mapped fields in the SavedObjects index ([#43673](https://github.com/elastic/kibana/issues/43673)). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
/* | ||
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one | ||
* or more contributor license agreements. Licensed under the Elastic License; | ||
* you may not use this file except in compliance with the Elastic License. | ||
*/ | ||
|
||
export const DEFAULT_SOURCE_ID = 'default'; |
Oops, something went wrong.