# Planned Migration for go.opentelemetry.io

LLMS index: [llms.txt](/llms.txt)

---

With contributions from Tyler Yahn and Austin Parker.

## TL;DR

The app that serves requests to [go.opentelemetry.io][] will be migrating to a
new host on September 5, 2024 at approximately 11:00AM Eastern Time. **There are
no changes required from you**. We are making this announcement because it is
possible, but unlikely, that there might be downtime during this transition.

## Details

OpenTelemetry is planning to migrate the application that serves all requests
for `go.opentelemetry.io` to a new host project on September 5, 2024. On this
date, the current DNS entries for `go.opentelemetry.io` will be updated to point
to the new host.

This should be a seamless transition, but there is the possibility of downtime
during this time. The OpenTelemetry engineers will be actively monitoring the
transition to minimize the risk.

### Affected resources

In the unlikely event of issues, the scope of these planned changes will affect
Go package downloads for the following domains:

- `go.opentelemetry.io/auto`
- `go.opentelemetry.io/build-tools`
- `go.opentelemetry.io/collector-contrib`
- `go.opentelemetry.io/collector`
- `go.opentelemetry.io/contrib`
- `go.opentelemetry.io/otel`
- `go.opentelemetry.io/proto`

Note that this includes users of any of the following artifacts:

- OpenTelemetry Go language libraries (including Contrib)
- OpenTelemetry Go Auto-Instrumentation libraries
- OpenTelemetry Collector libraries (including Contrib)
- OpenTelemetry Collector Builder.

## What you need to do

**There is no action required from you.** All imports using
`go.opentelemetry.io` (and submodule paths, for example
`go.opentelemetry.io/otel`) will continue to work. There are no plans to change
this.

## What you might notice

There is the possibility of the [go.opentelemetry.io][] domain experiencing
downtime during this transition. If this happens, you might see projects that
import `go.opentelemetry.io` modules failing to compile.

This could occur due to several factors, including delays in DNS propagation or
misconfiguration. We will have multiple maintainers working synchronously during
this time to minimize any downtime that occurs.

If you experience any issues following this transition, please reach out on
[Slack #otel-go](https://cloud-native.slack.com/archives/C01NPAXACKT) or
[create an issue](https://github.com/open-telemetry/opentelemetry-go-vanityurls/issues/new)
over
[opentelemetry-go-vanityurls](https://github.com/open-telemetry/opentelemetry-go-vanityurls).

## Why are we making this change?

This transition both helps modernize the application serving requests and
handles an ownership transfer, ensuring that we are able to continue providing
OpenTelemetry Go packages in a secure and robust manner.

For more details, see
[the community GitHub issue proposing this change](https://github.com/open-telemetry/community/issues/2260).

[go.opentelemetry.io]: https://go.opentelemetry.io