[Buildbot-devel] Retrieve specific fields from build steps logs or change sources?

[shiny knight]

I have a builder that is made of different steps, each build a different piece of my project.

The build is triggered when a commit is done on a git repo; for each commit I build.

I am trying to gather info about various data from each build; specifically, I would like to access the fields that has

- revision number and user that commit the change.
- logs for a specific step.

I am not able to see where this data is saved, nor how a builder can access the logs and changes done on the codebase, which triggered the build. I am writing a custom class that will inherit from shellCommand.
 The closest thing that I've found on the manual is the example of the mailNotifier, which send the last 80 column of the logs, but I do not really understand how do you refer to specific logs for a specific step.

I see that the log object has a getName() function, which can be used to grab a specific log by name, but how do you specify the step, from which you want to grab the log? Same goes for the revision that triggered the build; I have found no info related to how to retrieve this information.

Is there any example or section in the manual that explain how to do so?

Thanks in advance