This document discusses using Zipkin and OpenTracing to trace microservices applications. It covers the foundations of tracing including spans, inter-process propagation, and active span management. It provides examples of using Zipkin and the PHP Zipkin support library to create spans with annotations and set parent/child relationships between spans. The document recommends instrumenting frameworks to generate traces and using features like KV stores and events to include useful trace data. It cautions against creating too many spans or including too many details in span names.

1. Trace your micro-services oriented application with
Zipkin and OpenTracing
CNCF Italy - Turin

2. Walter Dal Mut
github.com/wdalmut
twitter.com/walterdalmut

3. corley.it

4. 3 Foundations

5. Logging

6. Too much details for realtime reading

7. Monitor

8. Aggretate

10. Measure Changes

11. Measure Changes (2)

13. Annotate things

14. (distributed)
Tracing

15. Tracing is about Spans, inter-process propagation
and active span management

16. Spans

17. Inter-process propagation
X-B3-TraceId: 1250938620936823095802313
X-B3-SpanId: 12435243758
X-B3-ParentSpanId: 1245675313
X-B3-Sampled: 1

18. ZipKin
zipkin.io

21. List/Filter operations

23. Underline errors

24. K/V store

25. Intra-services errors
open this trace

26. KV on errors

27. Events

28. Client Send - Server Receive and Events

29. Service dependencies

30. PHP ZipKin support library
https://github.com/wdalmut/php-zipkin

31. Create span 2annotations(sr,ss)
$span = new ServerReceive(
"get_users", // method name
"oauth2", // service name
"auth.corley:80" // IP:Port
);
$span->sent();

32. Create span 2annotations(cs,cr)
$span = new ClientSend(
"get_users", // method name
"oauth2", // service name
"auth.corley:80" // IP:Port
);
$span->receive();

33. Set as a child span
$span->childOf($parentSpan);

34. Get an existing span
$span = $tracer->findOneBy("kind", "root");

35. Use K/V store
$span
->getBinaryAnnotations()
->set("error", true);

36. Create an event annotation
$span->add("an_event");

37. Use your framework to instrument your app
https://github.com/wdalmut/opentracing-bundle

38. Query trace
thanks to doctrine events
doctrine:
dbal:
logging: true

39. Trace other services (cs,cr)
thanks to Guzzle middleware
http.handler:
class: GuzzleHttpHandlerCurlHandler
http.stack:
class: GuzzleHttpHandlerStack
calls:
- ["setHandler", ["@http.handler"]]
tags:
- { name: corley.auth.guzzle_handler_stack }
http.client:
class: GuzzleHttpClient
arguments:
- {"handler": "@http.stack"}

40. My biggest mistake...

41. too many spans (use sr,cs,ss,cr for the same span)

43. too much details (span name
/v1/user/walter.dalmut@gmail.com)

45. Conclusion

46. Measure is the key to science
Richard Feynman