Skip to content

Commit

Permalink
Merge branch 'main' into es-demo-folder
Browse files Browse the repository at this point in the history
  • Loading branch information
theletterf authored Aug 28, 2024
2 parents b07bb7e + 8463974 commit 503ef84
Show file tree
Hide file tree
Showing 30 changed files with 915 additions and 16 deletions.
83 changes: 83 additions & 0 deletions content/en/blog/2024/go-opentelemetry-io.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
---
title: Planned Migration for go.opentelemetry.io
date: 2024-08-27
author: '[Mike Dame](https://github.com/damemi) (Google)'
body_class: otel-with-contributions-from
issue: 5086
sig: Go SIG
cSpell:ignore: vanityurls Yahn
---

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
2 changes: 1 addition & 1 deletion content/en/docs/collector/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Collector
description: Vendor-agnostic way to receive, process and export telemetry data.
aliases: [collector/about]
cascade:
vers: 0.107.0
vers: 0.108.0
weight: 270
---

Expand Down
34 changes: 33 additions & 1 deletion content/en/docs/languages/go/exporters.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Exporters
aliases: [exporting_data]
weight: 50
# prettier-ignore
cSpell:ignore: otlplog otlploghttp otlpmetric otlpmetricgrpc otlpmetrichttp otlptrace otlptracegrpc otlptracehttp promhttp stdoutlog stdouttrace
cSpell:ignore: otlplog otlploggrpc otlploghttp otlpmetric otlpmetricgrpc otlpmetrichttp otlptrace otlptracegrpc otlptracehttp promhttp stdoutlog stdouttrace
---

{{% docs/languages/exporters/intro go %}}
Expand Down Expand Up @@ -86,6 +86,8 @@ Here's how you can create an exporter with default configuration:

```go
import (
"context"

"go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp"
"go.opentelemetry.io/otel/sdk/trace"
)
Expand All @@ -104,6 +106,8 @@ Here's how you can create an exporter with default configuration:

```go
import (
"context"

"go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc"
"go.opentelemetry.io/otel/sdk/trace"
)
Expand Down Expand Up @@ -138,6 +142,8 @@ Here's how you can create an exporter with default configuration:

```go
import (
"context"

"go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp"
"go.opentelemetry.io/otel/sdk/metric"
)
Expand All @@ -156,6 +162,8 @@ Here's how you can create an exporter with default configuration:

```go
import (
"context"

"go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetricgrpc"
"go.opentelemetry.io/otel/sdk/metric"
)
Expand All @@ -178,6 +186,8 @@ default configuration:

```go
import (
"context"

"go.opentelemetry.io/otel/exporters/prometheus"
"go.opentelemetry.io/otel/sdk/metric"
)
Expand All @@ -202,6 +212,8 @@ Here's how you can create an exporter with default configuration:

```go
import (
"context"

"go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp"
"go.opentelemetry.io/otel/sdk/log"
)
Expand All @@ -210,3 +222,23 @@ func newExporter(ctx context.Context) (log.Exporter, error) {
return otlploghttp.New(ctx)
}
```

### OTLP logs over gRPC (Experimental)

[`go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc`](https://pkg.go.dev/go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc)
contains an implementation of OTLP logs exporter using gRPC.

Here's how you can create an exporter with default configuration:

```go
import (
"context"

"go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploggrpc"
"go.opentelemetry.io/otel/sdk/log"
)

func newExporter(ctx context.Context) (log.Exporter, error) {
return otlploggrpc.New(ctx)
}
```
2 changes: 1 addition & 1 deletion content/en/ecosystem/integrations.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ While external instrumentation through
and
[instrumentation libraries](/docs/specs/otel/overview/#instrumentation-libraries)
provide a convenient way to make your application observable, we believe that
ultimately all applications should either integrated the OpenTelemetry APIs and
ultimately all applications should either integrate the OpenTelemetry APIs and
SDKs directly for native telemetry, or provide a first-party plugin that fits
into the ecosystem of the given software.

Expand Down
11 changes: 11 additions & 0 deletions content/es/docs/concepts/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
title: Conceptos de OpenTelemetry
linkTitle: Conceptos
description: Conceptos principales en OpenTelemetry
weight: 170
default_lang_commit: d638c386ae327328ff35604df54fa6ddd8b51b65
---

Esta sección describe las fuentes de datos y los componentes principales del
proyecto OpenTelemetry, lo que puede ayudarte a comprender cómo funciona
OpenTelemetry.
30 changes: 30 additions & 0 deletions content/es/docs/contributing/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
title: Contribuir
description: Aprende cómo contribuir a la documentación de OpenTelemetry.
weight: 980
default_lang_commit: 30783526402b69a3ac44eeb0f6cf066732f0bdca
---

Quienes colaboran para documentar OpenTelemetry:

- Mejoran el contenido existente.
- Crean contenido nuevo.
- Actualizan el Registro de OpenTelemetry.
- Mejoran el código que construye el sitio.

Las siguientes guías describen cómo contribuir a la documentación de
OpenTelemetry.

Para obtener orientación sobre cómo contribuir al proyecto OpenTelemetry en
general, consulta la
[Guía del contribuyente de OpenTelemetry](https://github.com/open-telemetry/community/blob/main/guides/contributor/README.md),
que proporciona detalles sobre el Acuerdo de Licencia del Contribuyente y el
Código de Conducta. Cada implementación de lenguaje, el Collector y las
convenciones en el [repositorio](https://github.com/open-telemetry/) tiene sus
propias guías específicas para contribuir.

## Otras formas de contribuir

- Visita el [sitio de la comunidad de OpenTelemetry](/community/).
- Añade tu aplicación al [Registro](/ecosystem).
- Envía un [blog o caso de estudio](/docs/contributing/blog/).
31 changes: 31 additions & 0 deletions content/es/docs/getting-started/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: Primeros pasos
description: Comienza con OpenTelemetry según tu rol.
no_list: true
default_lang_commit: e7a62891accc831de331336c8d10245969276112
weight: 160
---

Selecciona un rol[^1] para comenzar:

<div class="l-get-started-buttons justify-content-start mt-3 ms-3">

- [Dev](dev/)
- [Ops](ops/)

</div>

También puedes probar la [demo oficial de OpenTelemetry][demo] para ver cómo es
la observabilidad con OpenTelemetry.

<div class="l-primary-buttons justify-content-start mt-3 mb-5 ms-3">

- [Prueba la demostración][demo]

</div>

[^1]: Si ninguno de estos roles se aplica a tu caso, [abre un tique][].

[demo]: /ecosystem/demo/
[abre un tique]:
https://github.com/open-telemetry/opentelemetry.io/issues/new?title=Add%20a%20new%20persona:%20My%20Persona&body=Provide%20a%20description%20of%20your%20role%20and%20responsibilities%20and%20what%20your%20observability%20goals%20are
16 changes: 16 additions & 0 deletions content/es/docs/kubernetes/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
title: OpenTelemetry con Kubernetes
linkTitle: Kubernetes
weight: 350
description: Usando OpenTelemetry con Kubernetes
default_lang_commit: d638c386ae327328ff35604df54fa6ddd8b51b65
---

## Introducción

[Kubernetes](https://kubernetes.io/) es un sistema de código abierto para
automatizar la implementación, el escalado y la gestión de aplicaciones en
contenedores. Se ha convertido en una herramienta industrial ampliamente
adoptada, lo que genera una mayor necesidad de herramientas de observabilidad.
En respuesta, OpenTelemetry ha creado muchas herramientas diferentes para ayudar
a los usuarios de Kubernetes a observar sus clústeres y servicios.
6 changes: 6 additions & 0 deletions content/pt/announcements/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
title: Anúncios
cascade:
type: docs
default_lang_commit: 48eac183a4dd74946d5a45fa436cfc6052f30532
---
10 changes: 10 additions & 0 deletions content/pt/announcements/otel-localized.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
title: Site do OpenTelemetry com suporte a múltiplas linguas!
date: 2024-08-21
expiryDate: 2024-09-30
weight: -240821 # top
default_lang_commit: 48eac183a4dd74946d5a45fa436cfc6052f30532
---

<i class="fas fa-language"></i> {{% param title %}}
[Saiba mais](/blog/2024/docs-localized/)
6 changes: 6 additions & 0 deletions content/pt/blog/2024/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
title: 2024
weight: -2024
outputs: [HTML, RSS]
default_lang_commit: 48eac183a4dd74946d5a45fa436cfc6052f30532
---
38 changes: 38 additions & 0 deletions content/pt/blog/2024/docs-localized.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: Site do OpenTelemetry com suporte a múltiplos idiomas!
linkTitle: Site multilíngue
date: 2024-08-10
author: >-
[Severin Neumann](https://github.com/svrnm) (Cisco)
issue: 4863
sig: Comms
default_lang_commit: 48eac183a4dd74946d5a45fa436cfc6052f30532
---

É com grande prazer que anunciamos que o site do OpenTelemetry está disponível
em múltiplos idiomas! Os times de localização já começaram a traduzir páginas do
site para [Chinês](/zh), [Japonês](/ja), [Português](/pt) e [Espanhol](/es).

O projeto OpenTelemetry cresceu para incluir pessoas que contribuem e o utilizam
em todas as partes do mundo. Disponibilizar o site em múltiplos idiomas é um
passo importante para garantir que todos, independente da sua língua nativa,
consigam contribuir para o projeto. Nós também estamos empolgados que essa
iniciativa permite que usuários acessem a documentações em diversas linguagens,
facilitando o aprendizado e o entendimento do OpenTelemetry.

Para acessar o site na língua de sua preferência, utilize o seletor de idioma no
canto superior direito da página.

Venha contribuir para essa iniciativa. Você pode encontrar colegas que
contribuem para localização no canal do Slack
[#otel-docs-localization](https://cloud-native.slack.com/archives/C076RUAGP37).
Se você é fluente em um idioma que já é suportado, você pode ajudar criando ou
revisando traduções. Se seu idioma ainda não é suportado e você gostaria de
ajudar a traduzir,
[crie uma issue](<https://github.com/open-telemetry/opentelemetry.io/issues/new?title=Add+%3CYOUR%20LANGUAGE%3E+(%3CYOUR+CODE%3E)+version+of+website+pages&body=%3C!--+Provide+github+handles+of+at+least+2+people+that+will+work+on+this+translation+project%20--%3E>).

Suas contribuições podem gerar um impacto significativo!

Nós agradecemos todas as pessoas que contribuíram para tornar isso uma
realidade, e estamos ansiosos para ver como essas novas opções de idioma podem
melhorar a experiência de usuário do OpenTelemetry.
8 changes: 8 additions & 0 deletions content/pt/blog/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: Blog
menu:
main: { weight: 50 }
redirects: [{ from: '', to: '2024/ 301!' }]
outputs: [HTML, RSS]
default_lang_commit: 48eac183a4dd74946d5a45fa436cfc6052f30532
---
Loading

0 comments on commit 503ef84

Please sign in to comment.