Re: Documenting Metrics API?

[Aviem Zur]

There is an open task for this on JIRA:

https://issues.apache.org/jira/browse/BEAM-1974

On Tue, May 15, 2018 at 10:56 AM Etienne Chauchot 
wrote:

> Hi Pablo,
> I don't know if it is what you seek but we have at least this doc that is
> user facing but it is a bit old:
>
> https://docs.google.com/document/d/1voyUIQ2DrWkoY-BsJwM8YvF4gGKB76CDG8BYL8XBc7A/edit#heading=h.vv2fbulkp7t
>
> Etienne
>
> Le vendredi 11 mai 2018 à 15:00 -0700, Lukasz Cwik a écrit :
>
> The programming guide doesn't have the information your looking for. Like
> Kenn says it should have it but it currently doesn't.
>
> On Fri, May 11, 2018 at 1:02 PM Kenneth Knowles  wrote:
>
> I think the programming guide needs to have end-user documentation.
>
> Kenn
>
> On Fri, May 11, 2018 at 12:58 PM Lukasz Cwik  wrote:
>
> Are you speaking about metrics related to portability? If so, Alex shared
> this doc a while back: https://s.apache.org/beam-fn-api-metrics
>
> Otherwise, I'm not aware of any metrics related documentation for Apache
> Beam on the website.
>
>
>
> On Fri, May 11, 2018 at 12:02 PM Pablo Estrada  wrote:
>
> Hello all,
> I could not find a place were the Beam Metrics API is well detailed in the
> Beam website. Is there a JIRA tracking this? Perhaps our use-case driven
> docs + java/pydoc cover it well enough, but I'm not sure that that's the
> case.
>
> Thanks
> -P
> --
> Got feedback? go/pabloem-feedback
> 
>
>
>
>

Re: Documenting Metrics API?

[Etienne Chauchot]

Hi Pablo,
I don't know if it is what you seek but we have at least this doc that is user 
facing but it is a bit old:
https://docs.google.com/document/d/1voyUIQ2DrWkoY-BsJwM8YvF4gGKB76CDG8BYL8XBc7A/edit#heading=h.vv2fbulkp7t
Etienne
Le vendredi 11 mai 2018 à 15:00 -0700, Lukasz Cwik a écrit :
> The programming guide doesn't have the information your looking for. Like 
> Kenn says it should have it but it currently
> doesn't.
> 
> On Fri, May 11, 2018 at 1:02 PM Kenneth Knowles  wrote:
> > I think the programming guide needs to have end-user documentation.
> > 
> > Kenn
> > 
> > On Fri, May 11, 2018 at 12:58 PM Lukasz Cwik  wrote:
> > > Are you speaking about metrics related to portability? If so, Alex shared 
> > > this doc a while back: https://s.apache.
> > > org/beam-fn-api-metrics
> > > 
> > > Otherwise, I'm not aware of any metrics related documentation for Apache 
> > > Beam on the website.
> > > 
> > > 
> > > 
> > > On Fri, May 11, 2018 at 12:02 PM Pablo Estrada  wrote:
> > > > Hello all,
> > > > I could not find a place were the Beam Metrics API is well detailed in 
> > > > the Beam website. Is there a JIRA
> > > > tracking this? Perhaps our use-case driven docs + java/pydoc cover it 
> > > > well enough, but I'm not sure that that's
> > > > the case.
> > > > 
> > > > Thanks
> > > > -P 
> > > > -- 
> > > > Got feedback? go/pabloem-feedback
> > > > 

Re: Documenting Metrics API?

[Lukasz Cwik]

The programming guide doesn't have the information your looking for. Like
Kenn says it should have it but it currently doesn't.

On Fri, May 11, 2018 at 1:02 PM Kenneth Knowles  wrote:

> I think the programming guide needs to have end-user documentation.
>
> Kenn
>
> On Fri, May 11, 2018 at 12:58 PM Lukasz Cwik  wrote:
>
>> Are you speaking about metrics related to portability? If so, Alex shared
>> this doc a while back: https://s.apache.org/beam-fn-api-metrics
>>
>> Otherwise, I'm not aware of any metrics related documentation for Apache
>> Beam on the website.
>>
>>
>>
>> On Fri, May 11, 2018 at 12:02 PM Pablo Estrada 
>> wrote:
>>
>>> Hello all,
>>> I could not find a place were the Beam Metrics API is well detailed in
>>> the Beam website. Is there a JIRA tracking this? Perhaps our use-case
>>> driven docs + java/pydoc cover it well enough, but I'm not sure that that's
>>> the case.
>>>
>>> Thanks
>>> -P
>>> --
>>> Got feedback? go/pabloem-feedback
>>> 
>>>
>>

Re: Documenting Metrics API?

[Kenneth Knowles]

I think the programming guide needs to have end-user documentation.

Kenn

On Fri, May 11, 2018 at 12:58 PM Lukasz Cwik  wrote:

> Are you speaking about metrics related to portability? If so, Alex shared
> this doc a while back: https://s.apache.org/beam-fn-api-metrics
>
> Otherwise, I'm not aware of any metrics related documentation for Apache
> Beam on the website.
>
>
>
> On Fri, May 11, 2018 at 12:02 PM Pablo Estrada  wrote:
>
>> Hello all,
>> I could not find a place were the Beam Metrics API is well detailed in
>> the Beam website. Is there a JIRA tracking this? Perhaps our use-case
>> driven docs + java/pydoc cover it well enough, but I'm not sure that that's
>> the case.
>>
>> Thanks
>> -P
>> --
>> Got feedback? go/pabloem-feedback
>> 
>>
>

Re: Documenting Metrics API?

[Pablo Estrada]

I'm speaking about instructions on how to use Metrics.counter /
Metrics.distribution, etc when writing pipelines.
Best
-P.

On Fri, May 11, 2018 at 12:58 PM Lukasz Cwik  wrote:

> Are you speaking about metrics related to portability? If so, Alex shared
> this doc a while back: https://s.apache.org/beam-fn-api-metrics
>
> Otherwise, I'm not aware of any metrics related documentation for Apache
> Beam on the website.
>
>
>
> On Fri, May 11, 2018 at 12:02 PM Pablo Estrada  wrote:
>
>> Hello all,
>> I could not find a place were the Beam Metrics API is well detailed in
>> the Beam website. Is there a JIRA tracking this? Perhaps our use-case
>> driven docs + java/pydoc cover it well enough, but I'm not sure that that's
>> the case.
>>
>> Thanks
>> -P
>> --
>> Got feedback? go/pabloem-feedback
>> 
>>
> --
Got feedback? go/pabloem-feedback

Re: Documenting Metrics API?

[Lukasz Cwik]

Are you speaking about metrics related to portability? If so, Alex shared
this doc a while back: https://s.apache.org/beam-fn-api-metrics

Otherwise, I'm not aware of any metrics related documentation for Apache
Beam on the website.



On Fri, May 11, 2018 at 12:02 PM Pablo Estrada  wrote:

> Hello all,
> I could not find a place were the Beam Metrics API is well detailed in the
> Beam website. Is there a JIRA tracking this? Perhaps our use-case driven
> docs + java/pydoc cover it well enough, but I'm not sure that that's the
> case.
>
> Thanks
> -P
> --
> Got feedback? go/pabloem-feedback
> 
>