[GitHub] [tomee] daniel-augusto commented on a change in pull request #679: TOMEE:2869 Translate to Portuguese: examples/mp-metrics-metered

[GitBox <gi...@apache.org>]

daniel-augusto commented on a change in pull request #679:
URL: https://github.com/apache/tomee/pull/679#discussion_r453380649



##########
File path: examples/mp-metrics-metered/README_pt.adoc
##########
@@ -0,0 +1,163 @@
+= Métricas com MicroProfile `@Metered`
+:index-group: MicroProfile
+:jbake-type: page
+:jbake-status: published
+
+Este é um exemplo sobre como utilizar as métricas do MicroProfile em TomEE.
+
+== Executando a aplicação:
+
+[source,bash]
+----
+$ mvn clean install tomee:run
+----
+
+Dentro da aplicação, há um endpoint que vai fornecer o estado do clima para o dia e a semana.
+
+== Obtendo o clima para semana:
+
+[source,bash]
+----
+$ curl -X GET http://localhost:8080/mp-metrics-metered/weather/day/status
+----
+
+== Resposta:
+
+[source,text]
+----
+Hi, today is a sunny day!
+----
+
+== Usando `@Metered`
+
+As métricas do MicroProfile tem uma função que se pode usar para medir solicitações para um serviço.
+
+Para utilizar esta função, você deve anotar os métodos dos recursos JAX-RS com `@Metered`.
+
+[source,java]
+----
+@Path("/weather")
+@Produces(MediaType.APPLICATION_JSON)
+@Consumes(MediaType.APPLICATION_JSON)
+@ApplicationScoped
+public class WeatherService {
+
+    @Path("/day/status")
+    @Metered(name = "dailyStatus",
+             unit = MetricUnits.MINUTES,
+             description = "Metrics to daily weather status method",
+             absolute = true)
+    @GET
+    @Produces(MediaType.TEXT_PLAIN)
+    public String dayStatus() {
+        return "Hi, today is a sunny day!";
+    }
+}
+----
+
+Existem algumas configurações, como parte do `@Metered`, 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, ele prefixa 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.

Review comment:
       Please add a new line here.
   
   ```suggestion
   *String displayName* Opcional. Um nome de exibição legível para metadados.
   ```




----------------------------------------------------------------
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