You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomee.apache.org by GitBox <gi...@apache.org> on 2020/05/27 04:15:28 UTC
[GitHub] [tomee] marcoantoniobferreira commented on a change in pull request #655: Translate to Portuguese: examples/mp-metrics-counted
marcoantoniobferreira commented on a change in pull request #655:
URL: https://github.com/apache/tomee/pull/655#discussion_r430839230
##########
File path: examples/mp-metrics-counted/README_pt.adoc
##########
@@ -0,0 +1,179 @@
+= Métricas com MicroProfile `@Counted` (Contado)
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em Tomee. O projeto inclui um perfil de Docker que se pode usar para criar uma imagem de Docker.
Review comment:
`Este` instead of `Esta` and `MicroProfile no Tomee ` instead of `MicroProfile em Tomee`
##########
File path: examples/mp-metrics-counted/README_pt.adoc
##########
@@ -0,0 +1,179 @@
+= Métricas com MicroProfile `@Counted` (Contado)
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em Tomee. O projeto inclui um perfil de Docker que se pode usar para criar uma imagem de Docker.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+NOTE: Como alternativa, compile e execute o aplicativo através do Docker
+(observe o uso do perfil da janela de encaixe):
+
+[source,bash]
+----
+$ mvn -Pdocker docker:build
+----
+
+[source,bash]
+----
+$ docker run -it --rm -p 8080:8080 --name=tomee-mp-metrics-counted tomee/mp-metrics-counted
+----
+
+Dentro do aplicativo, há um terminal que fornecerá o estado do tempo para o dia e a semana.
+
+== Veja o clima da semana:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-counted/weather/week/status
+----
+
+IMPORTANT: Se você executar usando o Docker, devido o aplicativo está instalado
+como o aplicativo ROOT, remova o nome do aplicativo do URL:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/weather/week/status
+----
+
+== Resposta:
+
+[source,text]
+----
+Hi, today is a sunny day!
+----
+
+== Usando `@Counted`
+
+As métricas do MicroProfile têm uma função que pode ser usada para contar solicitações para um serviço.
+
+Para usar esta função, você deve anotar os métodos dos recursos JAX-RS com `@Counted`.
+
+[source,java]
+----
+@Path("/weather")
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+@ApplicationScoped
+public class WeatherService {
+
+ @Path("/day/status")
+ @Counted(monotonic = true, name = "weather_day_status", absolute = true)
+ @GET
+ @Produces(MediaType.TEXT_PLAIN)
+ public String dayStatus() {
+ return "Hi, today is a sunny day!";
+ }
+...
+}
+----
+
+Existem algumas configurações, como parte do `@Counted`, que você precisa saber:
+
+*String name* Opcional. Define o nome da métrica. Se não for fornecido
+explicitamente, o nome do objeto anotado é usado.
+
+*boolean absolute* Se verdadeiro, use o nome fornecido como o nome absoluto da métrica.
+Se falso, coloque o nome do pacote e o nome da classe antes do nome fornecido. O valor padrão é falso.
+
+*String displayName* Opcional. Um nome de exibição legível para
+metadados.
+
+*String description* Opcional. Uma descrição da métrica.
+
+*String[] tags* Opcional. Matriz de cadeia no formato = para fornecer
+etiquetas especiais para uma métrica.
+
+*boolean reusable* Indica se uma métrica com um determinado nome pode ser
+registre-se em mais de um local. Não se aplica a `@Gauges` (metros).
+
+== Dados Métricos
+
+Verifique a métrica do contador, fazendo uma solicitação _GET_:
+
+=== Formato Prometheus:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-counted/metrics/application/weather_day_status
+----
+
+=== Resposta Prometheus:
+
+[source,text]
+----
+# TYPE application:weather_day_status counter
+application:weather_day_status 1.0
+----
+
+=== Formato JSON:
+
+Para o formato json, adicione o cabeçalho `Accept:application/json` à solicitação HTTP.
+
+[source,bash]
+----
+$ curl -X GET -H "Accept: application/json" http://localhost:8080/mp-metrics-counted/metrics/application/weather_day_status
+----
+
+=== Resposta JSON:
+
+[source,javascript]
+----
+{
+ "weather_day_status": {
+ "delegate": {},
+ "unit": "none",
+ "count": 1
+ }
+}
+----
+
+== Metadatos Métrica
+
+Uma métrica terá metadados para que você possa aprender mais sobre ela, como `displayName`,`descrição`, `tags` etc.
+
+Verifique os metadados da métrica fazendo uma solicitação HTTP _OPTIONS_:
+
+=== Solicitação HTTP _OPTIONS_
Review comment:
`requisição` instead of `solicitação`
##########
File path: examples/mp-metrics-counted/README_pt.adoc
##########
@@ -0,0 +1,179 @@
+= Métricas com MicroProfile `@Counted` (Contado)
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em Tomee. O projeto inclui um perfil de Docker que se pode usar para criar uma imagem de Docker.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+NOTE: Como alternativa, compile e execute o aplicativo através do Docker
+(observe o uso do perfil da janela de encaixe):
+
+[source,bash]
+----
+$ mvn -Pdocker docker:build
+----
+
+[source,bash]
+----
+$ docker run -it --rm -p 8080:8080 --name=tomee-mp-metrics-counted tomee/mp-metrics-counted
+----
+
+Dentro do aplicativo, há um terminal que fornecerá o estado do tempo para o dia e a semana.
+
+== Veja o clima da semana:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-counted/weather/week/status
+----
+
+IMPORTANT: Se você executar usando o Docker, devido o aplicativo está instalado
+como o aplicativo ROOT, remova o nome do aplicativo do URL:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/weather/week/status
+----
+
+== Resposta:
+
+[source,text]
+----
+Hi, today is a sunny day!
+----
+
+== Usando `@Counted`
+
+As métricas do MicroProfile têm uma função que pode ser usada para contar solicitações para um serviço.
Review comment:
`requisições` instead of `solicitações`
##########
File path: examples/mp-metrics-counted/README_pt.adoc
##########
@@ -0,0 +1,179 @@
+= Métricas com MicroProfile `@Counted` (Contado)
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em Tomee. O projeto inclui um perfil de Docker que se pode usar para criar uma imagem de Docker.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+NOTE: Como alternativa, compile e execute o aplicativo através do Docker
+(observe o uso do perfil da janela de encaixe):
+
+[source,bash]
+----
+$ mvn -Pdocker docker:build
+----
+
+[source,bash]
+----
+$ docker run -it --rm -p 8080:8080 --name=tomee-mp-metrics-counted tomee/mp-metrics-counted
+----
+
+Dentro do aplicativo, há um terminal que fornecerá o estado do tempo para o dia e a semana.
+
+== Veja o clima da semana:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-counted/weather/week/status
+----
+
+IMPORTANT: Se você executar usando o Docker, devido o aplicativo está instalado
+como o aplicativo ROOT, remova o nome do aplicativo do URL:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/weather/week/status
+----
+
+== Resposta:
+
+[source,text]
+----
+Hi, today is a sunny day!
+----
+
+== Usando `@Counted`
+
+As métricas do MicroProfile têm uma função que pode ser usada para contar solicitações para um serviço.
+
+Para usar esta função, você deve anotar os métodos dos recursos JAX-RS com `@Counted`.
+
+[source,java]
+----
+@Path("/weather")
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+@ApplicationScoped
+public class WeatherService {
+
+ @Path("/day/status")
+ @Counted(monotonic = true, name = "weather_day_status", absolute = true)
+ @GET
+ @Produces(MediaType.TEXT_PLAIN)
+ public String dayStatus() {
+ return "Hi, today is a sunny day!";
+ }
+...
+}
+----
+
+Existem algumas configurações, como parte do `@Counted`, que você precisa saber:
+
+*String name* Opcional. Define o nome da métrica. Se não for fornecido
+explicitamente, o nome do objeto anotado é usado.
+
+*boolean absolute* Se verdadeiro, use o nome fornecido como o nome absoluto da métrica.
+Se falso, coloque o nome do pacote e o nome da classe antes do nome fornecido. O valor padrão é falso.
+
+*String displayName* Opcional. Um nome de exibição legível para
+metadados.
+
+*String description* Opcional. Uma descrição da métrica.
+
+*String[] tags* Opcional. Matriz de cadeia no formato = para fornecer
+etiquetas especiais para uma métrica.
+
+*boolean reusable* Indica se uma métrica com um determinado nome pode ser
+registre-se em mais de um local. Não se aplica a `@Gauges` (metros).
+
+== Dados Métricos
+
+Verifique a métrica do contador, fazendo uma solicitação _GET_:
+
+=== Formato Prometheus:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-counted/metrics/application/weather_day_status
+----
+
+=== Resposta Prometheus:
+
+[source,text]
+----
+# TYPE application:weather_day_status counter
+application:weather_day_status 1.0
+----
+
+=== Formato JSON:
+
+Para o formato json, adicione o cabeçalho `Accept:application/json` à solicitação HTTP.
+
+[source,bash]
+----
+$ curl -X GET -H "Accept: application/json" http://localhost:8080/mp-metrics-counted/metrics/application/weather_day_status
+----
+
+=== Resposta JSON:
+
+[source,javascript]
+----
+{
+ "weather_day_status": {
+ "delegate": {},
+ "unit": "none",
+ "count": 1
+ }
+}
+----
+
+== Metadatos Métrica
+
+Uma métrica terá metadados para que você possa aprender mais sobre ela, como `displayName`,`descrição`, `tags` etc.
Review comment:
`saber` instead of `aprender`
##########
File path: examples/mp-metrics-counted/README_pt.adoc
##########
@@ -0,0 +1,179 @@
+= Métricas com MicroProfile `@Counted` (Contado)
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em Tomee. O projeto inclui um perfil de Docker que se pode usar para criar uma imagem de Docker.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+NOTE: Como alternativa, compile e execute o aplicativo através do Docker
+(observe o uso do perfil da janela de encaixe):
Review comment:
`observe o uso do perfil docker` instead of `observe o uso do perfil da janela de encaixe`.
##########
File path: examples/mp-metrics-counted/README_pt.adoc
##########
@@ -0,0 +1,179 @@
+= Métricas com MicroProfile `@Counted` (Contado)
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em Tomee. O projeto inclui um perfil de Docker que se pode usar para criar uma imagem de Docker.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+NOTE: Como alternativa, compile e execute o aplicativo através do Docker
+(observe o uso do perfil da janela de encaixe):
+
+[source,bash]
+----
+$ mvn -Pdocker docker:build
+----
+
+[source,bash]
+----
+$ docker run -it --rm -p 8080:8080 --name=tomee-mp-metrics-counted tomee/mp-metrics-counted
+----
+
+Dentro do aplicativo, há um terminal que fornecerá o estado do tempo para o dia e a semana.
+
+== Veja o clima da semana:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-counted/weather/week/status
+----
+
+IMPORTANT: Se você executar usando o Docker, devido o aplicativo está instalado
+como o aplicativo ROOT, remova o nome do aplicativo do URL:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/weather/week/status
+----
+
+== Resposta:
+
+[source,text]
+----
+Hi, today is a sunny day!
+----
+
+== Usando `@Counted`
+
+As métricas do MicroProfile têm uma função que pode ser usada para contar solicitações para um serviço.
+
+Para usar esta função, você deve anotar os métodos dos recursos JAX-RS com `@Counted`.
+
+[source,java]
+----
+@Path("/weather")
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+@ApplicationScoped
+public class WeatherService {
+
+ @Path("/day/status")
+ @Counted(monotonic = true, name = "weather_day_status", absolute = true)
+ @GET
+ @Produces(MediaType.TEXT_PLAIN)
+ public String dayStatus() {
+ return "Hi, today is a sunny day!";
+ }
+...
+}
+----
+
+Existem algumas configurações, como parte do `@Counted`, que você precisa saber:
+
+*String name* Opcional. Define o nome da métrica. Se não for fornecido
+explicitamente, o nome do objeto anotado é usado.
+
+*boolean absolute* Se verdadeiro, use o nome fornecido como o nome absoluto da métrica.
+Se falso, coloque o nome do pacote e o nome da classe antes do nome fornecido. O valor padrão é falso.
+
+*String displayName* Opcional. Um nome de exibição legível para
+metadados.
+
+*String description* Opcional. Uma descrição da métrica.
+
+*String[] tags* Opcional. Matriz de cadeia no formato = para fornecer
+etiquetas especiais para uma métrica.
+
+*boolean reusable* Indica se uma métrica com um determinado nome pode ser
+registre-se em mais de um local. Não se aplica a `@Gauges` (metros).
Review comment:
`registrado` instead of `registre-se`
##########
File path: examples/mp-metrics-counted/README_pt.adoc
##########
@@ -0,0 +1,179 @@
+= Métricas com MicroProfile `@Counted` (Contado)
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em Tomee. O projeto inclui um perfil de Docker que se pode usar para criar uma imagem de Docker.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+NOTE: Como alternativa, compile e execute o aplicativo através do Docker
+(observe o uso do perfil da janela de encaixe):
+
+[source,bash]
+----
+$ mvn -Pdocker docker:build
+----
+
+[source,bash]
+----
+$ docker run -it --rm -p 8080:8080 --name=tomee-mp-metrics-counted tomee/mp-metrics-counted
+----
+
+Dentro do aplicativo, há um terminal que fornecerá o estado do tempo para o dia e a semana.
+
+== Veja o clima da semana:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-counted/weather/week/status
+----
+
+IMPORTANT: Se você executar usando o Docker, devido o aplicativo está instalado
+como o aplicativo ROOT, remova o nome do aplicativo do URL:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/weather/week/status
+----
+
+== Resposta:
+
+[source,text]
+----
+Hi, today is a sunny day!
+----
+
+== Usando `@Counted`
+
+As métricas do MicroProfile têm uma função que pode ser usada para contar solicitações para um serviço.
+
+Para usar esta função, você deve anotar os métodos dos recursos JAX-RS com `@Counted`.
+
+[source,java]
+----
+@Path("/weather")
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+@ApplicationScoped
+public class WeatherService {
+
+ @Path("/day/status")
+ @Counted(monotonic = true, name = "weather_day_status", absolute = true)
+ @GET
+ @Produces(MediaType.TEXT_PLAIN)
+ public String dayStatus() {
+ return "Hi, today is a sunny day!";
+ }
+...
+}
+----
+
+Existem algumas configurações, como parte do `@Counted`, que você precisa saber:
+
+*String name* Opcional. Define o nome da métrica. Se não for fornecido
+explicitamente, o nome do objeto anotado é usado.
+
+*boolean absolute* Se verdadeiro, use o nome fornecido como o nome absoluto da métrica.
+Se falso, coloque o nome do pacote e o nome da classe antes do nome fornecido. O valor padrão é falso.
+
+*String displayName* Opcional. Um nome de exibição legível para
+metadados.
+
+*String description* Opcional. Uma descrição da métrica.
+
+*String[] tags* Opcional. Matriz de cadeia no formato = para fornecer
+etiquetas especiais para uma métrica.
+
+*boolean reusable* Indica se uma métrica com um determinado nome pode ser
+registre-se em mais de um local. Não se aplica a `@Gauges` (metros).
+
+== Dados Métricos
+
+Verifique a métrica do contador, fazendo uma solicitação _GET_:
Review comment:
`requisição` instead of `solicitação`
##########
File path: examples/mp-metrics-counted/README_pt.adoc
##########
@@ -0,0 +1,179 @@
+= Métricas com MicroProfile `@Counted` (Contado)
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em Tomee. O projeto inclui um perfil de Docker que se pode usar para criar uma imagem de Docker.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+NOTE: Como alternativa, compile e execute o aplicativo através do Docker
+(observe o uso do perfil da janela de encaixe):
+
+[source,bash]
+----
+$ mvn -Pdocker docker:build
+----
+
+[source,bash]
+----
+$ docker run -it --rm -p 8080:8080 --name=tomee-mp-metrics-counted tomee/mp-metrics-counted
+----
+
+Dentro do aplicativo, há um terminal que fornecerá o estado do tempo para o dia e a semana.
Review comment:
`há um endpoint` instead of `há um terminal`
##########
File path: examples/mp-metrics-counted/README_pt.adoc
##########
@@ -0,0 +1,179 @@
+= Métricas com MicroProfile `@Counted` (Contado)
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em Tomee. O projeto inclui um perfil de Docker que se pode usar para criar uma imagem de Docker.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+NOTE: Como alternativa, compile e execute o aplicativo através do Docker
+(observe o uso do perfil da janela de encaixe):
+
+[source,bash]
+----
+$ mvn -Pdocker docker:build
+----
+
+[source,bash]
+----
+$ docker run -it --rm -p 8080:8080 --name=tomee-mp-metrics-counted tomee/mp-metrics-counted
+----
+
+Dentro do aplicativo, há um terminal que fornecerá o estado do tempo para o dia e a semana.
+
+== Veja o clima da semana:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-counted/weather/week/status
+----
+
+IMPORTANT: Se você executar usando o Docker, devido o aplicativo está instalado
Review comment:
`IMPORTANTE` instead of `IMPORTANT` and `porque` instead of `devido`
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org