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 03:36:15 UTC
[GitHub] [tomee] Daniel-Dos opened a new pull request #656: Translate to Portuguese: examples/mp-metrics-gauge
Daniel-Dos opened a new pull request #656:
URL: https://github.com/apache/tomee/pull/656
Link to Jira: https://issues.apache.org/jira/browse/TOMEE-2833
----------------------------------------------------------------
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
[GitHub] [tomee] Daniel-Dos commented on a change in pull request #656: Translate to Portuguese: examples/mp-metrics-gauge
Posted by GitBox <gi...@apache.org>.
Daniel-Dos commented on a change in pull request #656:
URL: https://github.com/apache/tomee/pull/656#discussion_r431510008
##########
File path: examples/mp-metrics-gauge/README_pt.adoc
##########
@@ -0,0 +1,153 @@
+= Métricas com MicroProfile `@Gauge` (Medida)
+
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em TomEE.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+Dentro da aplicação, tem um endpoint que vai fornecer a temperatura em celsios para o día.
+
+== Obter a temperatura para o dia:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-gauge/weather/day/temperature
+----
+
+== Resposta:
+ 30
+
+== Usando `@Gauge`
+
+As métricas do MicroProfile têm uma função para medir.
+O valor e o tipo da medida são iguais ao valor e ao tipo do método anotado.
+
+Para usar esta função, você deve anotar os métodos dos recursos JAX-RS com `@Gauge`.
+
+[source,java]
+----
+@Path("/weather")
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+@ApplicationScoped
+public class WeatherService {
+
+ @Path("/day/temperature")
+ @Gauge(name = "weather_day_temperature", absolute = true, unit = "celsius",
+ displayName = "Weather Day Temperature",
+ description = "This metric shows the day temperature.",
+ tags = {"weather=temperature"})
+ @GET
+ @Produces(MediaType.TEXT_PLAIN)
+ public Integer dayTemperature() {
+ return 30;
+ }
+}
+----
+
+Existem algumas configurações, como parte do `@Gauge`, 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 a uma métrica.
+
+*String unit*
+Unidade da métrica. Veja a classe MetricUnits para obter uma lista de unidades padrão.
+
+== Dados Métricos
+
+Verifique a medida fazendo uma solicitação _GET_:
+
+=== Formato Prometheus:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-gauge/metrics/application/weather_day_temperature
+----
+
+=== Resposta Prometheus:
+
+[source]
+----
+ # TYPE application:weather_day_temperature_celsius gauge
+ application:weather_day_temperature_celsius{weather="temperature"} 30.0
+----
+
+=== Formato JSON:
+
+Para o formato json, adicione o cabeçalho Accept=application/json à solicitação.
+
+=== Resposta JSON
+
+[source,javascript]
+----
+ {
+ "weather_day_temperature": 30
+ }
+----
+
+== 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_:
Review comment:
done
----------------------------------------------------------------
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
[GitHub] [tomee] Daniel-Dos commented on pull request #656: Translate to Portuguese: examples/mp-metrics-gauge
Posted by GitBox <gi...@apache.org>.
Daniel-Dos commented on pull request #656:
URL: https://github.com/apache/tomee/pull/656#issuecomment-651216392
Hello @hbelmiro and @marcoantoniobferreira thanks for review :
----------------------------------------------------------------
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
[GitHub] [tomee] Daniel-Dos merged pull request #656: Translate to Portuguese: examples/mp-metrics-gauge
Posted by GitBox <gi...@apache.org>.
Daniel-Dos merged pull request #656:
URL: https://github.com/apache/tomee/pull/656
----------------------------------------------------------------
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
[GitHub] [tomee] Daniel-Dos commented on a change in pull request #656: Translate to Portuguese: examples/mp-metrics-gauge
Posted by GitBox <gi...@apache.org>.
Daniel-Dos commented on a change in pull request #656:
URL: https://github.com/apache/tomee/pull/656#discussion_r431510053
##########
File path: examples/mp-metrics-gauge/README_pt.adoc
##########
@@ -0,0 +1,153 @@
+= Métricas com MicroProfile `@Gauge` (Medida)
+
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em TomEE.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+Dentro da aplicação, tem um endpoint que vai fornecer a temperatura em celsios para o día.
+
+== Obter a temperatura para o dia:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-gauge/weather/day/temperature
+----
+
+== Resposta:
+ 30
+
+== Usando `@Gauge`
+
+As métricas do MicroProfile têm uma função para medir.
+O valor e o tipo da medida são iguais ao valor e ao tipo do método anotado.
+
+Para usar esta função, você deve anotar os métodos dos recursos JAX-RS com `@Gauge`.
+
+[source,java]
+----
+@Path("/weather")
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+@ApplicationScoped
+public class WeatherService {
+
+ @Path("/day/temperature")
+ @Gauge(name = "weather_day_temperature", absolute = true, unit = "celsius",
+ displayName = "Weather Day Temperature",
+ description = "This metric shows the day temperature.",
+ tags = {"weather=temperature"})
+ @GET
+ @Produces(MediaType.TEXT_PLAIN)
+ public Integer dayTemperature() {
+ return 30;
+ }
+}
+----
+
+Existem algumas configurações, como parte do `@Gauge`, 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 a uma métrica.
+
+*String unit*
+Unidade da métrica. Veja a classe MetricUnits para obter uma lista de unidades padrão.
+
+== Dados Métricos
+
+Verifique a medida fazendo uma solicitação _GET_:
+
+=== Formato Prometheus:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-gauge/metrics/application/weather_day_temperature
+----
+
+=== Resposta Prometheus:
+
+[source]
+----
+ # TYPE application:weather_day_temperature_celsius gauge
+ application:weather_day_temperature_celsius{weather="temperature"} 30.0
+----
+
+=== Formato JSON:
+
+Para o formato json, adicione o cabeçalho Accept=application/json à solicitação.
Review comment:
done
##########
File path: examples/mp-metrics-gauge/README_pt.adoc
##########
@@ -0,0 +1,153 @@
+= Métricas com MicroProfile `@Gauge` (Medida)
+
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em TomEE.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+Dentro da aplicação, tem um endpoint que vai fornecer a temperatura em celsios para o día.
Review comment:
done
----------------------------------------------------------------
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
[GitHub] [tomee] marcoantoniobferreira commented on a change in pull request #656: Translate to Portuguese: examples/mp-metrics-gauge
Posted by GitBox <gi...@apache.org>.
marcoantoniobferreira commented on a change in pull request #656:
URL: https://github.com/apache/tomee/pull/656#discussion_r430836968
##########
File path: examples/mp-metrics-gauge/README_pt.adoc
##########
@@ -0,0 +1,153 @@
+= Métricas com MicroProfile `@Gauge` (Medida)
+
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em TomEE.
Review comment:
The rigth is 'Este é um' instead of 'Esta é um'
##########
File path: examples/mp-metrics-gauge/README_pt.adoc
##########
@@ -0,0 +1,153 @@
+= Métricas com MicroProfile `@Gauge` (Medida)
+
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em TomEE.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+Dentro da aplicação, tem um endpoint que vai fornecer a temperatura em celsios para o día.
Review comment:
`celsius` instead of `celsios`.
`dia` instead of `día`.
##########
File path: examples/mp-metrics-gauge/README_pt.adoc
##########
@@ -0,0 +1,153 @@
+= Métricas com MicroProfile `@Gauge` (Medida)
+
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em TomEE.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+Dentro da aplicação, tem um endpoint que vai fornecer a temperatura em celsios para o día.
+
+== Obter a temperatura para o dia:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-gauge/weather/day/temperature
+----
+
+== Resposta:
+ 30
+
+== Usando `@Gauge`
+
+As métricas do MicroProfile têm uma função para medir.
+O valor e o tipo da medida são iguais ao valor e ao tipo do método anotado.
+
+Para usar esta função, você deve anotar os métodos dos recursos JAX-RS com `@Gauge`.
+
+[source,java]
+----
+@Path("/weather")
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+@ApplicationScoped
+public class WeatherService {
+
+ @Path("/day/temperature")
+ @Gauge(name = "weather_day_temperature", absolute = true, unit = "celsius",
+ displayName = "Weather Day Temperature",
+ description = "This metric shows the day temperature.",
+ tags = {"weather=temperature"})
+ @GET
+ @Produces(MediaType.TEXT_PLAIN)
+ public Integer dayTemperature() {
+ return 30;
+ }
+}
+----
+
+Existem algumas configurações, como parte do `@Gauge`, 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 a uma métrica.
+
+*String unit*
+Unidade da métrica. Veja a classe MetricUnits para obter uma lista de unidades padrão.
+
+== Dados Métricos
+
+Verifique a medida fazendo uma solicitação _GET_:
+
+=== Formato Prometheus:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-gauge/metrics/application/weather_day_temperature
+----
+
+=== Resposta Prometheus:
+
+[source]
+----
+ # TYPE application:weather_day_temperature_celsius gauge
+ application:weather_day_temperature_celsius{weather="temperature"} 30.0
+----
+
+=== Formato JSON:
+
+Para o formato json, adicione o cabeçalho Accept=application/json à solicitação.
Review comment:
`requisição` instead of `solicitação`.
##########
File path: examples/mp-metrics-gauge/README_pt.adoc
##########
@@ -0,0 +1,153 @@
+= Métricas com MicroProfile `@Gauge` (Medida)
+
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em TomEE.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+Dentro da aplicação, tem um endpoint que vai fornecer a temperatura em celsios para o día.
+
+== Obter a temperatura para o dia:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-gauge/weather/day/temperature
+----
+
+== Resposta:
+ 30
+
+== Usando `@Gauge`
+
+As métricas do MicroProfile têm uma função para medir.
+O valor e o tipo da medida são iguais ao valor e ao tipo do método anotado.
+
+Para usar esta função, você deve anotar os métodos dos recursos JAX-RS com `@Gauge`.
+
+[source,java]
+----
+@Path("/weather")
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+@ApplicationScoped
+public class WeatherService {
+
+ @Path("/day/temperature")
+ @Gauge(name = "weather_day_temperature", absolute = true, unit = "celsius",
+ displayName = "Weather Day Temperature",
+ description = "This metric shows the day temperature.",
+ tags = {"weather=temperature"})
+ @GET
+ @Produces(MediaType.TEXT_PLAIN)
+ public Integer dayTemperature() {
+ return 30;
+ }
+}
+----
+
+Existem algumas configurações, como parte do `@Gauge`, 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 a uma métrica.
+
+*String unit*
+Unidade da métrica. Veja a classe MetricUnits para obter uma lista de unidades padrão.
+
+== Dados Métricos
+
+Verifique a medida fazendo uma solicitação _GET_:
+
+=== Formato Prometheus:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-gauge/metrics/application/weather_day_temperature
+----
+
+=== Resposta Prometheus:
+
+[source]
+----
+ # TYPE application:weather_day_temperature_celsius gauge
+ application:weather_day_temperature_celsius{weather="temperature"} 30.0
+----
+
+=== Formato JSON:
+
+Para o formato json, adicione o cabeçalho Accept=application/json à solicitação.
+
+=== Resposta JSON
+
+[source,javascript]
+----
+ {
+ "weather_day_temperature": 30
+ }
+----
+
+== 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_:
Review comment:
`requisição` instead of `solicitação`.
----------------------------------------------------------------
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
[GitHub] [tomee] Daniel-Dos commented on a change in pull request #656: Translate to Portuguese: examples/mp-metrics-gauge
Posted by GitBox <gi...@apache.org>.
Daniel-Dos commented on a change in pull request #656:
URL: https://github.com/apache/tomee/pull/656#discussion_r431510129
##########
File path: examples/mp-metrics-gauge/README_pt.adoc
##########
@@ -0,0 +1,153 @@
+= Métricas com MicroProfile `@Gauge` (Medida)
+
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Esta é um exemplo sobre como utilizar as métricas de MicroProfile em TomEE.
Review comment:
done thanks
----------------------------------------------------------------
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