<!-- Use this template as a starting point for deprecations. --> ### Deprecation Summary <!-- This should contain a brief description of the feature or functionality that is deprecated. The description should clearly state the potential impact of the deprecation to end users. It is recommended that you link to the documentation. The description of the deprecation should state what actions the user should take to rectify the behavior. If the deprecation is scheduled for an upcoming release, the content should remain in the deprecations documentation page until it has been completed. For example, if a deprecation is announced in 14.9 and scheduled to be completed in 15.0, the same content would be included in the documentation for 14.9, 14.10, and 15.0. --> **Summary of the feature that is being deprecated:** We previously launched a solution that allows users to view performance metrics by displaying data stored in a Prometheus instance. The Prometheus instance can be setup as a GitLab managed app or the user can connect a previously configured Prometheus instance. The latter is known as an "external Prometheus" in GitLab lingo. The value we provided was to enable the user to easily set up monitoring (using GitLab Managed Apps) and have the visualization of the metrics all in the same tool you used to build the application. However, since we are deprecating certificate-based integrations, the full monitoring experience is also deprecated as the user will not have the option to easily setup Prometheus all from within GitLab. Furthermore, with the acquisition of OpsTrace, we should consolidate on a single user experience instead of allowing users multiple paths on how to view metrics. Because of this, we will deprecate the external Prometheus experience, together with the metrics visualization capability, as well. For users that want to bring their own pre-configured and operational Prometheus, they can instead forward the metrics to GitLab Observability once we make that capability available. This deprecation **does not** include: - Deprecating [alerts for Prometheus](https://docs.gitlab.com/ee/operations/metrics/alerts.html#external-prometheus-instances) - [Capabilities that GitLab comes with that allow operators of GitLab to retrieve metrics from those instances](https://docs.gitlab.com/ee/administration/monitoring/prometheus/gitlab_metrics.html) **Documentation:** - [Prometheus Metrics library](https://docs.gitlab.com/ee/user/project/integrations/prometheus_library/) - [Custom dashboards](https://docs.gitlab.com/ee/operations/metrics/dashboards/) - `DO NOT DEPRECATE OR REMOVE` [Alerts for Prometheus](https://docs.gitlab.com/ee/operations/metrics/alerts.html#external-prometheus-instances) ### Proposal - [x] %"14.7" documentation changes are made to reflect features that are being deprecated, https://gitlab.com/gitlab-org/gitlab/-/merge_requests/77417 - [x] %"14.7" Deprecation MR, https://gitlab.com/gitlab-org/gitlab/-/merge_requests/77420 - [x] %"14.8" in-product shows the features that are being deprecated. https://gitlab.com/gitlab-org/gitlab/-/issues/350601 - [x] %"15.10" Deprecation message added to the `CHANGELOG.md` file - [x] %"15.10" Technical Breakdown for feature removal, https://gitlab.com/gitlab-org/monitor/respond/-/issues/109+ - [ ] %"16.0" Removal MR - [ ] %"16.0" Deprecated code removed in %"16.0": MR (consider removing code in multiple phases/MRs) - UI removal (required for %"16.0") - API removal (required for %"16.0") - Backend removal (can be done in future milestones if necessary) Here is a link to the [Deprecations, removals, and breaking changes](https://about.gitlab.com/handbook/marketing/blog/release-posts/#deprecations-removals-and-breaking-changes) process. ```Note: A deprecation needs to have an initial announcement in the release post notifying the community at least two releases in advance of the date of planned removal. Deprecations should also be included in the documentation for at least 2 releases prior to the final removal.``` ### Breaking Change <!-- Is this a breaking change or not? If so, please add instructions for how users can update their workflow. --> ### Affected Topology **TBD** <!-- Who is affected by this deprecation, Self-managed users, SaaS users, or both? This is especially important when nearing the annual major release where breaking changes and removals are typically introduced. These changes might be seen on GitLab.com before the official release date. --> ### Affected Tier <!-- Which tier is this feature available in? * Free * Premium * Ultimate --> ### Checklist - [ ] This issue/epic is shared with the team at a team meeting for ~"group::monitor" - [ ] @mention your stage's stable counterparts on this issue. For example, Customer Support, Customer Success (Technical Account Manager), Product Marketing Manager. - To see who the stable counterparts are for a product team visit [product categories](https://about.gitlab.com/handbook/product/categories/) - If there is no stable counterpart listed for Sales/CS please mention `@timtams` - If there is no stable counterpart listed for Support please @mention `@gitlab-com/support/managers` - If there is no stable counterpart listed for Marketing please mention `@williamchia` - [ ] @mention your GPM so that they are aware of planned deprecations. The goal is to have reviews happen at least two releases before the final removal of the feature or introduction of a breaking change. - [ ] Post the announcement of this deprecation in the following Slack Channels: * [ ] #ops-section * [ ] gitlab#37993 ### Deprecation Milestone <!-- In which milestone will this deprecation be announced ? --> In which milestone will this deprecation be announced? %"14.8" ### Planned Removal Milestone <!-- In which milestone will the feature or functionality be removed and announced? --> In which milestone will the feature or functionality be removed and announced? %"15.0" ### Links These issues will also be resolved by the completion of this removal: - https://gitlab.com/gitlab-org/gitlab/-/issues/391068+ - https://gitlab.com/gitlab-org/gitlab/-/issues/391022+ - https://gitlab.com/gitlab-org/gitlab/-/issues/390979+ - https://gitlab.com/gitlab-org/gitlab/-/issues/391020+ This removal is blocking https://gitlab.com/gitlab-org/gitlab/-/issues/391812+. <!-- Add links to any relevant documentation or code that will provide additional details or clarity regarding the planned change. Also, include a link to the removal issue if relevant. -->